/api/v4/locations/reviews/respond/editMengedit tanggapan terhadap interaksi
Mengedit tanggapan pemilik yang sebelumnya dipublikasikan pada ulasan atau interaksi.
Parameter
Body
| Nama | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| responseId | string | wajib | ID of the response to edit (the `id` from an interaction's `responses` array). |
| reviewId | string | wajib | ID of the interaction the response belongs to. |
| responseContent | string | wajib | Updated text content of the response. |
| templateId | string | opsional | Response-template ID to re-attribute the edited reply to, if any. |
Contoh permintaan
Body siap tempel. Ganti ID dan nilai placeholder dengan milik Anda.
{ "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."}Respons
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.
Memperbarui isi tanggapan pemilik yang sudah ada. Tanggapan yang diedit dikirim ulang ke platform sumber secara asinkron, dan interactionStatus tanggapan tersebut kembali ke CREATED lalu beralih ke COMPLETED atau CONFIRMED setelah platform mengonfirmasi pembaruan (lihat alur status tanggapan).
reviewId (interaksi) dan responseId (balasan tertentu) keduanya wajib disertakan. Dapatkan responseId dari responses[].id milik interaksi melalui Dapatkan interaksi berdasarkan ID atau Daftar interaksi.
Kasus penggunaan: memperbaiki kesalahan ketik dalam balasan yang sudah dipublikasikan
Jika balasan pemilik yang sudah dipublikasikan memiliki kesalahan, edit balasan tersebut secara langsung alih-alih mengarsipkan dan memublikasikannya ulang; cara ini mempertahankan balasan pada platform (seperti Google) yang hanya mengizinkan satu tanggapan per ulasan. Cari array responses milik interaksi, ambil id dari balasan yang akan diperbaiki, lalu jalankan 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 bernilai "true" berarti pengeditan telah diterima; panggil Dapatkan interaksi berdasarkan ID secara berkala untuk memastikan balasan yang diperbarui mencapai CONFIRMED di situs sumber.
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." }'