상호작용 속성 참조

상호작용 객체는 사업장의 상호작용 목록 조회, 통합 상호작용 조회 및 ID로 상호작용 조회에서 반환됩니다. 페이지네이션을 지원하는 2개의 엔드포인트는 이 객체들을 Relay 스타일 커넥션으로 감싸며, data.interactions(사업장별)와 data.rollupInteractions(계정 내 통합)는 각각 edges[].node, pageInfo 및 totalCount를 포함합니다. ID로 조회할 때는 페이지네이션을 사용하지 않으며, data.interactionDetails는 edges, pageInfo 또는 totalCount가 없는 일반 { "interactions": [ ... ] } 객체입니다.

상호작용 필드

필드	유형	설명
id	String	상호작용의 UUID입니다. 답글을 작성할 때 `interactionId`로 전달합니다.
interactionId	String	`id`와 동일한 UUID입니다.
source	String	리뷰 또는 소셜 사이트의 호스트 이름입니다(예: `maps.google.com`, `yelp.com`).
title	String	소스에서 제공하는 경우 상호작용의 제목입니다.
content	String	리뷰 또는 게시물의 본문 텍스트입니다.
authorName	String	작성자의 표시 이름입니다.
rating	Integer	1–5점의 별점입니다(리뷰에만 해당).
date	String	상호작용의 ISO 8601 형식 타임스탬프입니다.
permalink	String	소스 사이트의 해당 상호작용으로 바로 연결되는 링크입니다.
category	String	상위 수준의 분류입니다(예: `Review` 또는 `Social`).
type	String	구체적인 상호작용 유형입니다(`Review`, `Question`, `Comment`, `Recommendation`, `Post`, `Photo`, `Message`, `Response`).
responded	Boolean	소유자의 답글이 있는지 여부입니다.
notes	String	계정 소유자의 비공개 메모입니다.
responses	Array	이 상호작용에 연결된 소유자의 답글입니다(아래 참조).
responseCount	Integer	연결된 답글의 수입니다.
canRespond	Boolean	이 소스에 Listings API를 통해 답글을 게시할 수 있는지 여부입니다.
locationId	Integer	상호작용이 속한 사업장의 숫자형 데이터베이스 ID입니다.
flaggedReason	String	상호작용에 플래그가 지정된 경우 그 이유입니다.

답글 객체 필드

상호작용의 responses 배열에 있는 각 항목(및 상호작용에 답글 작성에서 반환하는 객체)의 필드는 다음과 같습니다:

필드	유형	설명
id	String	고유한 답글 ID입니다(수정하거나 보관 처리할 때 `responseId`로 전달합니다).
interactionId	String	이 답글이 속한 상호작용의 ID입니다.
content	String	답글의 텍스트입니다.
authorName	String	답글 작성자로 표시되는 이름입니다.
date	String	답글이 생성된 시점의 타임스탬프입니다.
respondedWith	String	사용된 답글 템플릿이 있는 경우 해당 템플릿의 ID입니다.
respondedBy	Integer	답글을 제출한 Listings API 사용자의 ID입니다.
interactionStatus	String	수명 주기 상태이며, `CREATED`, `FAILED`, `COMPLETED` 또는 `CONFIRMED`입니다.
editedResponse	Boolean	이 답글이 처음 게시된 이후 수정되었는지 여부입니다.
remarks	String	시스템 비고입니다(예: 실패 세부 정보).

답글 상태 흐름

interactionStatus 필드는 답글이 소스 사이트에 게시되는 과정을 추적합니다:

CREATED → COMPLETED: 게시 플랫폼에 게시되었으며, 해당 플랫폼에서는 이중 확인을 사용할 수 없습니다.
CREATED → COMPLETED → CONFIRMED: 게시된 후 게시 플랫폼에서 확인되었습니다.
CREATED → FAILED: 게시 플랫폼에 제출하지 못했습니다. remarks를 참조합니다.

필터 열거형

페이지네이션을 지원하는 엔드포인트는 다음 열거형 값을 필터로 허용합니다:

responseStatus: RESPONDED, PENDING
sortOrder: NEWEST_FIRST, OLDEST_FIRST, LAST_RESPONDED
category: REVIEW(및 계정별로 제공되는 기타 상위 수준의 분류)