Listings APIListings API
로그인
POST/api/v4/locations/reviews/respond/edit

상호작용에 대한 답글 수정

리뷰 또는 상호작용에 이전에 게시한 소유자 답글을 수정합니다.

API 키가 필요합니다. 헤더 형식과 키 교체는 인증을 참고하세요.

매개변수

본문

이름유형필수설명
responseIdstring필수ID of the response to edit (the `id` from an interaction's `responses` array).
reviewIdstring필수ID of the interaction the response belongs to.
responseContentstring필수Updated text content of the response.
templateIdstring선택Response-template ID to re-attribute the edited reply to, if any.

요청 예시

바로 붙여 넣을 수 있는 본문입니다. 예시 ID와 값을 실제 값으로 바꾸세요.

Request body
{  "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."}

응답

200Edit accepted and queued for re-submission. `data.editResponse` returns the identifiers.
Response
{  "data": {    "editResponse": {      "status": "true",      "reviewId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841",      "responseId": "2090753a-ece6-4837-8336-8494ad308523"    }  }}
401Unauthenticated, missing or invalid API key.

기존 소유자 답글의 내용을 업데이트합니다. 수정된 답글은 원본 플랫폼에 비동기적으로 다시 제출되며, 해당 답글의 interactionStatus는 CREATED 상태로 돌아갔다가 플랫폼에서 업데이트를 확인하면 COMPLETED 또는 CONFIRMED 상태로 전환됩니다(답글 상태 흐름 참조).

reviewId(상호작용)와 responseId(특정 답글)가 모두 필요합니다. ID로 상호작용 조회 또는 상호작용 목록 조회를 통해 상호작용의 responses[].id에서 responseId를 가져옵니다.

사용 사례: 게시된 답글의 오타 수정

게시된 소유자 답글에 오류가 있으면 보관 처리 후 다시 게시하는 대신 기존 답글을 직접 수정하면, 리뷰당 답글을 1개만 허용하는 플랫폼(예: Google)에서도 답글을 유지할 수 있습니다. 상호작용의 responses 배열을 조회하고, 수정할 답글의 id를 가져온 다음 POST를 실행합니다:

JSON
{  "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가 "true"이면 수정 요청이 수락되었음을 의미하며, ID로 상호작용 조회를 폴링하여 업데이트된 답글이 원본 사이트에서 CONFIRMED 상태에 도달하는지 확인합니다.

Request
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."  }'
Run in playground