/api/v4/reviews/site-configBir hesabın yorum kaynaklarını listeleyin
Hesabın kullanabileceği yorum platformlarını döndürür. Google Maps ve Facebook her planda, Yelp ise Growth ve Enterprise planlarında kullanılabilir.
Parametreler
Bu uç nokta parametre almaz.
Yanıtlar
200Account-level review source catalog.
{ "data": { "interactionSiteConfig": [ { "site": "Google", "siteUrl": "maps.google.com" }, { "site": "Facebook", "siteUrl": "facebook.com" }, { "site": "Yelp", "siteUrl": "yelp.com" } ] }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
Hesabın aboneliği kapsamında kullanma hakkına sahip olduğu yorum kaynağı platformlarının tam kataloğunu döndürür. Yukarıdaki yanıt, Launch planındaki bir hesabın güncel kataloğudur; sitelerin tam listesi plana ve sektöre bağlıdır.
Kullanım örneği: Bir konumu yapılandırmadan önce name değerlerini doğrulayın
siteUrl alanı, yorum API'sinin diğer tüm bölümlerinde kullanılan standart site tanımlayıcısıdır. Bir konumun Google ve Facebook profillerini bağladığınızda yorum kaynakları otomatik olarak doldurulur; manuel ekleme veya düzenleme adımı yoktur. Etkileşimleri listeleme endpoint'indeki geçerli siteUrls filtre değerlerini öğrenmek için bu kataloğu kullanın.
Kullanım örneği: Bir "yorumlarınızı bağlayın" kullanıcı arayüzü oluşturun
Konum sahibinin her platform için profil URL'sini yapıştırabilmesi için döndürülen her siteye bir satır ayırın. Bağlı kaynaklarla kullanılabilir kaynakları göstermek için hesap genelindeki bu kataloğu (mümkün olanları), Bir konumun yorum kaynaklarını listeleyin (tek bir konum için zaten bağlı olanları) ile birlikte kullanın.
Bu endpoint parametre almaz ve hesap kapsamındadır; bu nedenle sonuç çağrılar arasında değişmez, her konum için yeniden almak yerine önbelleğe alın. Hesabın istek hızı sınırına tabidir; 429 durumunda, Retry-After başlığını kullanarak yeniden denemeden önce bekleyin.
curl -X GET 'https://listingsapi.com/api/v4/reviews/site-config' \ -H "Authorization: API $LISTINGSAPI_KEY"