/api/v4/locations/reviews/respondBir etkileşime yanıt verin
Bir yoruma veya etkileşime, kaynak platformunda herkese açık bir yanıt gönderir.
Parametreler
Gövde
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| interactionId | string | zorunlu | UUID of the interaction to respond to. Take it from an interaction's `id` or `interactionId`, which are the same value. It is a plain UUID, with no numeric or Base64 Relay form. |
| responseContent | string | zorunlu | Text content of the response to post. |
| respondedWith | string | isteğe bağlı | Response-template ID to attribute the reply to, if it was generated from a template. |
Örnek istek
Yapıştırmaya hazır gövde. Yer tutucu kimlikleri ve değerleri kendi değerlerinizle değiştirin.
{ "interactionId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "responseContent": "Thank you for visiting Jenny Home: we're glad you enjoyed your experience!"}Yanıtlar
200Response accepted and queued for posting. `data.respondToInteraction.interaction` holds the created response.
{ "data": { "respondToInteraction": { "interaction": { "id": "2090753a-ece6-4837-8336-8494ad308523", "interactionId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "content": "Thank you for visiting Jenny Home: we're glad you enjoyed your experience!", "interactionStatus": "CREATED", "editedResponse": false }, "errors": null } }}401Unauthenticated, missing or invalid API key.
Sık karşılaşılan hatalar
- SY50121: Google Reviews accept only a single owner reply per review; a second response is rejected.
Bir yoruma veya etkileşime, kaynak platformunda (e.g. Google, Facebook) yanıt gönderir. Yanıt eşzamansız olarak gönderilir: interactionStatus hemen CREATED olur ve platform yanıtı onayladığında COMPLETED veya CONFIRMED durumuna geçer (ya da FAILED durumuna geçer; yanıt durumu akışına bakın).
Her platform işletme sahibinin yanıt vermesini desteklemez. Çağrı yapmadan önce etkileşim nesnesindeki canRespond alanını kontrol edin. Google Reviews, yorum başına yalnızca bir yanıt kabul eder (tekrar denendiğinde SY50121 döndürülür); yeni bir yanıt göndermek yerine mevcut yanıtı değiştirmek için Bir yanıtı düzenleyin işlemini kullanın.
Kullanım senaryosu: yeni 5 yıldızlı yorumlara otomatik yanıt verme
Memnun yorum sahiplerine otomatik olarak teşekkür etmek için Etkileşimleri listeleyin işlemini ratingFilters=[5] ve responseStatus=["PENDING"] ile düzenli aralıklarla sorgulayın; ardından döndürülen ve canRespond değeri true olan her node için, id değerini interactionId olarak ve responseContent değerinizi kullanarak POST isteği gönderin:
{ "interactionId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "responseContent": "Thank you for visiting Jenny Home: we're glad you enjoyed your experience!"}Gönderim eşzamansız olduğundan, 200 sonucuna dayanarak işlemin başarılı olduğunu varsaymak yerine yanıtın COMPLETED/CONFIRMED durumuna ulaştığını doğrulamak için etkileşimi Kimliklere göre etkileşimleri alın işlemiyle yeniden alın.
curl -X POST 'https://listingsapi.com/api/v4/locations/reviews/respond' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "interactionId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "responseContent": "Thank you for visiting Jenny Home: we're glad you enjoyed your experience!" }'