연결된 계정 세부 정보 조회

이름	유형	필수	설명
connectedAccountId	string	필수	UUID of the connected account (from the list connected accounts endpoint).

이름

유형

필수

설명

connectedAccountId

string

필수

UUID of the connected account (from the list connected accounts endpoint).

응답

200Connected account details.

Response

{  "data": {    "connectedAccountDetails": {      "details": {        "accountId": "12345",        "clientName": "owner@brightsmile-dental.com",        "connectedAccountId": "4f712c17-4f95-42dd-90f4-97171a2e67b5",        "connectedAccountType": "GoogleAccount",        "connectedLocationsCount": 0,        "connectivityIssue": null,        "email": "owner@brightsmile-dental.com",        "lastFetchMatchesRequestedAt": "2026-07-06 21:43:07 UTC",        "remarks": null,        "requestMatches": false,        "requestMatchesStatus": "MATCH_COMPLETED",        "status": "CONNECTED"      }    }  }}

401Unauthenticated, missing or invalid API key.

429Rate limit exceeded. Retry after the `Retry-After` header value.

connectedAccountId로 지정한 연결된 계정 1개의 전체 세부 정보 레코드를 가져옵니다. 목록 엔드포인트의 레코드 1개와 동일한 필드를 반환하지만 조회 범위가 계정 1개로 한정되므로, 이미 ID가 있는 경우 전체 목록을 페이지 단위로 조회하는 것보다 비용이 적게 듭니다.

사용 사례: 새로 연결된 계정 폴링. 고객이 Google 연결 절차를 완료하면 connectedAccountId를 받지만 매칭 항목 조회는 비동기로 실행됩니다. 이 엔드포인트를 폴링하고 requestMatchesStatus의 변화를 확인합니다. 연결 제안이 준비되면 MATCH_IN_PROGRESS에서 MATCH_COMPLETED로 바뀌며, 이때 connection-suggestions 엔드포인트에서 연결 제안을 조회할 수 있습니다.

사용 사례: 재인증 안내 표시. 계정을 통해 업데이트를 전송하기 전에 status 및 connectivityIssue를 조회합니다. 상태가 CONNECTED가 아니거나 connectivityIssue에 값이 있으면 OAuth 권한 부여가 만료되었다는 뜻이므로, 실패할 게시를 시도하는 대신 앱에서 고객에게 다시 연결하라고 안내합니다. connectedLocationsCount는 현재 해당 계정에 연결된 Listings API 사업장 수를 나타냅니다.

연결된 계정 세부 정보 조회

매개변수

경로

응답