/api/v4/locations/reviews/respond/editBir etkileşime verilen yanıtı düzenleme
Bir yorum veya etkileşim için daha önce yayımlanmış işletme sahibi yanıtını düzenler.
Parametreler
Gövde
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| responseId | string | zorunlu | ID of the response to edit (the `id` from an interaction's `responses` array). |
| reviewId | string | zorunlu | ID of the interaction the response belongs to. |
| responseContent | string | zorunlu | Updated text content of the response. |
| templateId | string | isteğe bağlı | Response-template ID to re-attribute the edited reply to, if any. |
Örnek istek
Yapıştırmaya hazır gövde. Yer tutucu kimlikleri ve değerleri kendi değerlerinizle değiştirin.
{ "reviewId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "responseId": "2090753a-ece6-4837-8336-8494ad308523", "responseContent": "Thank you again: we've updated our reply to include our new store hours."}Yanıtlar
200Edit accepted and queued for re-submission. `data.editResponse` returns the identifiers.
{ "data": { "editResponse": { "status": "true", "reviewId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "responseId": "2090753a-ece6-4837-8336-8494ad308523" } }}401Unauthenticated, missing or invalid API key.
Mevcut bir işletme sahibi yanıtının içeriğini günceller. Düzenlenen yanıt, kaynak platforma eşzamansız olarak yeniden gönderilir; yanıtın interactionStatus değeri CREATED değerine döner ve platform güncellemeyi onayladığında COMPLETED veya CONFIRMED değerine geçer (bkz. yanıt durumu akışı).
Hem reviewId (etkileşim) hem de responseId (belirli yanıt) gereklidir. Kimliklere göre etkileşimleri getirme veya Etkileşimleri listeleme aracılığıyla bir etkileşimin responses[].id alanından responseId değerini alın.
Kullanım örneği: yayındaki bir yanıtta yazım hatasını düzeltme
Yayımlanmış bir işletme sahibi yanıtında hata olduğunda, yanıtı arşivleyip yeniden yayımlamak yerine yerinde düzenleyin; bu işlem, yorum başına yalnızca bir yanıta izin veren platformlarda (Google gibi) yanıtı korur. Etkileşimin responses dizisine bakın, düzeltilecek yanıtın id değerini alın ve POST:
{ "reviewId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "responseId": "2090753a-ece6-4837-8336-8494ad308523", "responseContent": "Thank you again: we've updated our reply to include our new store hours."}status değerinin "true" olması, düzenlemenin kabul edildiği anlamına gelir; güncellenen yanıtın kaynak sitede CONFIRMED durumuna ulaştığını doğrulamak için Kimliklere göre etkileşimleri getirme üzerinden düzenli aralıklarla sorgulama yapın.
curl -X POST 'https://listingsapi.com/api/v4/locations/reviews/respond/edit' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "reviewId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "responseId": "2090753a-ece6-4837-8336-8494ad308523", "responseContent": "Thank you again: we've updated our reply to include our new store hours." }'