/api/v4/locations/reviews/respond/editEditar una respuesta a una interacción
Edita una respuesta del propietario publicada previamente en una reseña o interacción.
Parámetros
Cuerpo
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| responseId | string | obligatorio | ID of the response to edit (the `id` from an interaction's `responses` array). |
| reviewId | string | obligatorio | ID of the interaction the response belongs to. |
| responseContent | string | obligatorio | Updated text content of the response. |
| templateId | string | opcional | Response-template ID to re-attribute the edited reply to, if any. |
Solicitud de ejemplo
Cuerpo listo para pegar. Sustituye los ID y valores de ejemplo por los tuyos.
{ "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."}Respuestas
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.
Actualiza el contenido de una respuesta existente del propietario. La respuesta editada se vuelve a enviar a la plataforma de origen de forma asíncrona, su interactionStatus vuelve a CREATED y pasa a COMPLETED o CONFIRMED una vez que la plataforma confirma la actualización (consulta el flujo de estados de la respuesta).
Se requieren tanto reviewId (la interacción) como responseId (la respuesta concreta). Obtén el responseId del responses[].id de una interacción mediante Obtener interacciones por sus IDs o Enumerar interacciones.
Caso de uso: corregir un error tipográfico en una respuesta publicada
Cuando una respuesta publicada del propietario tenga un error, edítala directamente en lugar de archivarla y volver a publicarla; esto conserva la respuesta en las plataformas (como Google) que solo permiten una respuesta por reseña. Consulta el array responses de la interacción, toma el id de la respuesta que quieras corregir y usa 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 status de "true" significa que se ha aceptado la edición; consulta periódicamente Obtener interacciones por sus IDs para confirmar que la respuesta actualizada alcanza el estado CONFIRMED en el sitio de origen.
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." }'