/api/v4/locations/reviews/respond/editEine Antwort auf eine Interaktion bearbeiten
Bearbeitet eine zuvor veröffentlichte Inhaberantwort auf eine Bewertung oder Interaktion.
Parameter
Body
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| responseId | string | erforderlich | ID of the response to edit (the `id` from an interaction's `responses` array). |
| reviewId | string | erforderlich | ID of the interaction the response belongs to. |
| responseContent | string | erforderlich | Updated text content of the response. |
| templateId | string | optional | Response-template ID to re-attribute the edited reply to, if any. |
Beispielanfrage
Body zum direkten Einfügen. Ersetzen Sie Platzhalter-IDs und -Werte durch Ihre eigenen.
{ "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."}Antworten
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.
Aktualisiert den Inhalt einer vorhandenen Inhaberantwort. Die bearbeitete Antwort wird asynchron erneut an die Quellplattform übermittelt; ihr interactionStatus kehrt zu CREATED zurück und wechselt zu COMPLETED oder CONFIRMED, sobald die Plattform die Aktualisierung bestätigt (siehe Statusablauf für Antworten).
Sowohl reviewId (die Interaktion) als auch responseId (die konkrete Antwort) sind erforderlich. Entnehmen Sie responseId dem Feld responses[].id einer Interaktion über Interaktionen anhand von IDs abrufen oder Interaktionen auflisten.
Anwendungsfall: Einen Tippfehler in einer veröffentlichten Antwort korrigieren
Wenn eine veröffentlichte Inhaberantwort einen Fehler enthält, bearbeiten Sie sie direkt, statt sie zu archivieren und erneut zu veröffentlichen; dadurch bleibt die Antwort auf Plattformen (wie Google) erhalten, die nur eine Antwort pro Bewertung zulassen. Rufen Sie das Array responses der Interaktion ab, entnehmen Sie daraus die id der zu korrigierenden Antwort und führen Sie POST aus:
{ "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."}Ein status von "true" bedeutet, dass die Bearbeitung angenommen wurde; rufen Sie Interaktionen anhand von IDs abrufen regelmäßig ab, um zu bestätigen, dass die aktualisierte Antwort auf der Quellwebsite den Status CONFIRMED erreicht.
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." }'