/api/v4/locations/reviews/respond/editModifica una risposta a un'interazione
Modifica una risposta del proprietario pubblicata in precedenza su una recensione o un'interazione.
Parametri
Corpo
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| responseId | string | obbligatorio | ID of the response to edit (the `id` from an interaction's `responses` array). |
| reviewId | string | obbligatorio | ID of the interaction the response belongs to. |
| responseContent | string | obbligatorio | Updated text content of the response. |
| templateId | string | facoltativo | Response-template ID to re-attribute the edited reply to, if any. |
Richiesta di esempio
Corpo pronto da incollare. Sostituisci gli ID e i valori segnaposto con i tuoi.
{ "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."}Risposte
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.
Aggiorna il contenuto di una risposta esistente del proprietario. La risposta modificata viene inviata nuovamente alla piattaforma di origine in modo asincrono; il suo interactionStatus torna a CREATED e passa a COMPLETED o CONFIRMED quando la piattaforma conferma l'aggiornamento (vedi il flusso degli stati della risposta).
Sono obbligatori sia reviewId (l'interazione) sia responseId (la risposta specifica). Ottieni responseId da responses[].id di un'interazione tramite Ottieni interazioni per ID o Elenca interazioni.
Caso d'uso: correggere un errore di battitura in una risposta pubblicata
Quando una risposta pubblicata del proprietario contiene un errore, modificala direttamente anziché archiviarla e pubblicarla di nuovo; questo preserva la risposta sulle piattaforme (come Google) che consentono una sola risposta per recensione. Consulta l'array responses dell'interazione, prendi id della risposta da correggere ed esegui 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."}Un valore di "true" per status indica che la modifica è stata accettata; interroga periodicamente Ottieni interazioni per ID per confermare che la risposta aggiornata raggiunga lo stato CONFIRMED sul sito di origine.
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." }'