/api/v4/locations/reviews/settings/editBir konumun yorum ayarlarını düzenleyin
Bir konumun hangi yorum kaynaklarında izlendiğini ve olumlu yorum eşiğini belirler.
Parametreler
Gövde
Zorunlu olarak işaretlenen iç içe bir alan yalnızca üst alanını gönderdiğinizde geçerlidir. Üst alan isteğe bağlıysa ve onu göndermezseniz, zorunlu alt alanları da geçerli olmaz.
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| locationId | string | zorunlu | Location to update, as its Base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`). This is a body field, so unlike path parameters a raw numeric ID is not converted and fails with `SY90002: Invalid Id`. |
| siteUrls | array | isteğe bağlı | The complete set of review sources for the location. This REPLACES the current selection, so send every source you want kept, not just the additions. |
| siteUrls[].name | string | isteğe bağlı | Site key, as returned in `siteSettings[].name` (e.g. `maps.google.com`, `yelp.com`). |
| siteUrls[].url | string | isteğe bağlı | The location's page URL on that site. Send `null` or omit to stop monitoring a source that needs an explicit URL. |
| positiveInteractionThreshold | integer | isteğe bağlı | Star rating at or above which a review counts as positive. Sent on its own, it leaves the source selection untouched. |
Örnek istek
Yapıştırmaya hazır gövde. Yer tutucu kimlikleri ve değerleri kendi değerlerinizle değiştirin.
{ "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "positiveInteractionThreshold": 4, "siteUrls": [ { "name": "maps.google.com", "url": null }, { "name": "yelp.com", "url": "https://www.yelp.com/biz/blue-bottle-coffee-oakland" } ]}Yanıtlar
200Settings applied. `data.editInteractionsSetting.interactionSetting` returns the stored settings; `errors` is `null` on success.
{ "data": { "editInteractionsSetting": { "errors": null, "interactionSetting": { "id": "1800289", "locationId": "1800289", "positiveInteractionThreshold": 4, "siteSettings": [ { "name": "maps.google.com", "url": null, "monitored": true, "canRespond": true }, { "name": "yelp.com", "url": "https://www.yelp.com/biz/blue-bottle-coffee-oakland", "monitored": true, "canRespond": false } ] } } }}401Unauthenticated, missing or invalid API key.
403The key is valid but not permitted to change review settings for this location (`SY90003`).
Bir konumun izlendiği yorum kaynaklarını ve bir yorumun olumlu sayılması için gereken puanı günceller. Aynı ayarları okumak için Bir konumun yorum kaynaklarını listeleyin bölümüne bakın.
siteUrls kısmi güncelleme yapmaz, mevcut seçimin yerini alır. Gönderdiğiniz dizi, konumun kaynak seçimi olur. Bir kaynak eklemek için önce mevcut siteSettings değerini okuyun ve mevcut öğeleri yeni öğeyle birlikte geri gönderin; tek öğeli bir dizi göndermek, diğer tüm kaynakları herhangi bir uyarı vermeden kaldırır.
İki alan birbirinden bağımsızdır. Kaynaklara dokunmadan eşiği değiştirmek için yalnızca positiveInteractionThreshold, eşiğe dokunmadan kaynakları değiştirmek için yalnızca siteUrls gönderin.
Bir kaynak eklemek, bu kaynaktan veri çekme işlemini zamanlar; dolayısıyla yeni eklenen bir sitenin yorumları bu yanıtta gelmez, asenkron olarak gelir. Doğrulama sırasında reddedilen bir kaynak (erişilemeyen bir URL veya hesabın planına dahil olmayan bir kaynak), ayar değiştirilmeden errors içinde döndürülür; bu nedenle 200 yanıtında bile errors değerini kontrol edin.
Kullanım senaryosu: bir konumun Yelp sayfasını izlemeye alma
Bir konum oluşturulduktan hemen sonra Google ve Facebook kaynakları otomatik olarak izlenir, ancak Yelp sayfasının açıkça belirtilmesi gerekir. Ayarların uç noktasından mevcut seçimi okuyun, { "name": "yelp.com", "url": "<the location's Yelp URL>" } öğesini ekleyin ve dizinin tamamını konumun ID değeriyle birlikte geri gönderin. Veri çekme işlemi hemen kuyruğa alınır ve tamamlandığında ilk Yelp yorumları Etkileşimleri listeleyin bölümünde görünür.
Bu uç nokta, etkin izleme ayarlarını değiştirir. Yukarıdaki örnek istek ve yanıt, örnek olarak verilmiştir.
curl -X POST 'https://listingsapi.com/api/v4/locations/reviews/settings/edit' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "positiveInteractionThreshold": 4, "siteUrls": [ { "name": "maps.google.com", "url": null }, { "name": "yelp.com", "url": "https://www.yelp.com/biz/blue-bottle-coffee-oakland" } ] }'