연결된 계정의 GMB 폴더 목록 조회

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

이름

유형

필수

설명

connectedAccountId

string

필수

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

응답

200Array of GMB folder objects.

Response

{  "data": {    "getFoldersUnderGoogleAccount": [      {        "folderId": "accounts/104890024806530350198",        "folderName": "Aniruddha Basu",        "locationCount": null      }    ]  }}

401Unauthenticated, missing or invalid API key.

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

연결된 Google 계정에서 접근할 수 있는 Google Business Profile의 폴더(그룹 또는 계정 그룹이라고도 함)를 반환합니다. GBP는 폴더를 사용하여 계정 아래의 비즈니스 등록 정보를 정리하며, 각 폴더에는 folderId, folderName, 그리고 Google에서 제공하는 경우 locationCount가 포함됩니다.

사용 사례: 새 등록 정보를 올바른 폴더에 배치. create-GMB-listing 엔드포인트를 호출하기 전에 계정의 폴더 목록을 조회하고 고객이 폴더 하나를 선택하도록 합니다. 새 등록 정보가 계정 루트가 아닌 해당 폴더 안에 생성되도록 선택한 folderId(accounts/{id} 문자열을 그대로 사용)를 전달합니다.

사용 사례: 고객의 GBP 구조와 대조. 여러 사업장을 운영하는 브랜드는 등록 정보를 여러 폴더로 나누는 경우가 많습니다. 폴더 목록을 가져와 고객의 실제 GBP 계층 구조를 UI에 표시하고 고객이 예상하는 폴더로 동기화하고 있는지 확인합니다. Google이 폴더의 사업장 수를 반환하지 않으면 locationCount가 null일 수 있으므로, 신뢰할 수 있는 값이 아니라 선택적 값으로 취급합니다. 이 엔드포인트에는 Google 유형의 연결된 계정이 필요하며, 해당 경로는 GoogleAccount 연결에만 유효합니다.

매개변수

경로

응답