/api/v4/locations/{locationId}/reviews/settingsBir konumun yorum kaynaklarını listeleme
Tek bir konum için yapılandırılmış yorum kaynaklarını bağlantı URL'leriyle birlikte döndürür.
Parametreler
Yol
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| locationId | string | zorunlu | Location to read. Accepts a base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or a raw numeric location ID. |
Yanıtlar
200Review-source sites and their configured URLs for the location.
{ "data": { "interactionsSetting": { "siteSettings": [ { "name": "maps.google.com", "url": null }, { "name": "facebook.com", "url": null }, { "name": "yelp.com", "url": null } ] } }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
Bir konumun yorum kaynağı ayarlarını döndürür. siteSettings içindeki her öğe, hesabın planının desteklediği bir platformdur. url değerinin null olmaması, ilgili platformun bağlı olduğu ve Listings API'nin bu URL'den yorumları aldığı anlamına gelir; null url olması ise (henüz üçüncü taraf kaynaklarının bağlanmadığı canlı konum Jenny Home için yukarıda gösterildiği gibi) platformun kullanılabilir olduğu ancak henüz yapılandırılmadığı anlamına gelir.
Kullanım senaryosu: hâlâ URL eklenmesi gereken kaynakları bulma
Bu listeyi alın ve bir konum sahibinin hâlâ bağlaması gereken platformların yapılacaklar listesini oluşturmak için url: null koşuluna göre filtreleyin. Konumun Google ve Facebook profilleri bağlandığında yorum kaynakları otomatik olarak eklenir; eksik URL'leri doldurmak için bu hesapları bağlayın:
{ "name": "yelp.com", "url": "https://www.yelp.com/biz/your-listing" }Düzenlemeden sonra aynı platform, url alanında null yerine doldurulmuş bir değerle döndürülür.
Kullanım senaryosu: bir konum grubundaki bağlı kaynakları denetleme
Yorum kaynağı kapsamını raporlamak için (Tüm konumları listeleme üzerinden aldığınız) konumlarınızı bir döngüde işleyin ve bu endpoint'i her konum için çağırın. Konum başına bir istek yapıldığından, hesabın istek hızı sınırına uyun, çağrıları zamana yayın ve 429 durumunda arka arkaya istek göndermek yerine Retry-After başlığında belirtilen süre geçtikten sonra yeniden deneyin.
OAuth üzerinden bağlanan Google ve Facebook otomatik olarak bağlı görünür ve düzenleme endpoint'i aracılığıyla üzerlerine yazılamaz. Planın destekleyebileceği tüm platformları görmek için hesap genelinde çalışan Bir hesabın yorum kaynaklarını listeleme endpoint'ini kullanın.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/reviews/settings' \ -H "Authorization: API $LISTINGSAPI_KEY"