Listings APIListings API
로그인
POST/api/v4/connected-accounts/disconnect-google

Google 계정 연결 해제

연결된 Google Business Profile 계정 전체를 Listings API 계정에서 연결 해제합니다.

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

매개변수

본문

이름유형필수설명
inputobject필수Wrapper object. The entire request body must be nested under `input`.
input.connectedAccountIdstring필수UUID of the connected Google account to disconnect. The whole account is disconnected.

요청 예시

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

Request body
{  "input": {    "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d"  }}

응답

200Request accepted. `success: true` confirms the disconnect was processed.
Response
{  "data": {    "gmbBulkDisconnect": {      "success": true    }  }}
400Bad request, the body was not wrapped in `input`, or `connectedAccountId` was omitted (error message: `Field value.connectedAccountId of required type String! was not provided`).
401Unauthenticated, missing or invalid API key.

연결된 Google Business Profile 계정과 Listings API 계정 간의 연결을 끊습니다. 연결이 해제되면 해당 계정을 통해 동기화되던 등록 정보는 더 이상 Listings API의 업데이트를 받지 않습니다.

요청 형식. 본문은 connectedAccountId만 필드로 갖는 input 객체로 감싸야 합니다. 이 작업은 계정 단위로만 처리되며, Google 계정 전체와 해당 계정을 통해 연결된 모든 사업장의 연결이 해제됩니다. locationIds 필드는 없으며, 이 필드를 포함하면 스키마에서 거부합니다. 계정 연결은 유지하면서 단일 사업장의 등록 정보 연결만 해제하려면 disconnect-listing 엔드포인트를 사용합니다.

사용 사례: 고객 이탈 시 연결 전체 해제. connectedAccountId를 전송하면 한 번의 호출로 연결 전체를 해제할 수 있습니다. 이는 고객이 서비스를 해지하거나 Google 계정의 소유권을 이전한 후 Listings API의 접근 권한을 깔끔하게 철회하는 방법입니다.

사용 사례: 문제가 있는 연결 해제. Google 연결에 재인증으로 해결할 수 없는 자격 증명 오류가 있으면 이 엔드포인트에서 연결을 해제하고 connect-google 엔드포인트로 새 링크를 발급합니다. Facebook 계정에는 동일한 요청 형식을 사용하는 disconnect-facebook 엔드포인트를 사용합니다. 알 수 없는 connectedAccountId에도 success: true 응답이 반환되므로, 성공은 활성 연결이 제거되었다는 증거가 아니라 "요청이 처리되었다"는 의미로 해석하고, 확실한 확인이 필요하면 GET /connected-accounts로 계정 상태를 확인합니다.

이 엔드포인트는 활성 연결을 변경하고 Listings API의 Google 접근 권한을 철회합니다. 위의 요청 형식과 샘플 응답은 API 명세를 바탕으로 문서화되었으며, 해당 호출은 프로덕션 데이터를 대상으로 실행되지 않습니다.

Request
curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/disconnect-google' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d"    }  }'
Run in playground