/api/v4/locations/reviews/respond/editModifier une réponse à une interaction
Modifie une réponse du propriétaire précédemment publiée sur un avis ou une interaction.
Paramètres
Corps
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| responseId | string | obligatoire | ID of the response to edit (the `id` from an interaction's `responses` array). |
| reviewId | string | obligatoire | ID of the interaction the response belongs to. |
| responseContent | string | obligatoire | Updated text content of the response. |
| templateId | string | facultatif | Response-template ID to re-attribute the edited reply to, if any. |
Exemple de requête
Corps prêt à coller. Remplacez les identifiants et valeurs d’exemple par les vôtres.
{ "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."}Réponses
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.
Met à jour le contenu d’une réponse existante du propriétaire. La réponse modifiée est soumise à nouveau à la plateforme source de manière asynchrone, son interactionStatus repasse à CREATED, puis à COMPLETED ou CONFIRMED une fois que la plateforme confirme la mise à jour (voir le cycle de statut des réponses).
reviewId (l’interaction) et responseId (la réponse spécifique) sont tous deux requis. Récupérez responseId dans responses[].id d’une interaction via Obtenir les interactions par leurs identifiants ou Lister les interactions.
Cas d’utilisation : corriger une faute de frappe dans une réponse publiée
Lorsqu’une réponse publiée du propriétaire contient une erreur, modifiez-la directement plutôt que de l’archiver et de la republier ; cela préserve la réponse sur les plateformes (comme Google) qui n’autorisent qu’une seule réponse par avis. Consultez le tableau responses de l’interaction, prenez le id de la réponse à corriger et utilisez 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 égal à "true" signifie que la modification a été acceptée ; interrogez régulièrement Obtenir les interactions par leurs identifiants pour confirmer que la réponse mise à jour atteint CONFIRMED sur le site source.
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." }'