Verification API와 Business Information API가 출시되었습니다. 이전 작업이 필요하며, 지원 중단된 엔드포인트에 대해 자세히 알아보려면 지원 중단 일정을 참고하세요. Google 메일링 리스트에 가입하면 업데이트 사항을 이메일로 받아볼 수 있습니다.

대규모로 위치 관리

조직의 규모가 커질수록 위치 및 권한 관리가 어려울 수 있습니다. 이 가이드에서는 여러 위치를 관리하기 위한 권장사항 및 다음과 같은 계정 유형을 설명합니다.

계정 유형

각 계정 유형에는 위치 관리를 위한 역할이 있습니다. 개인 계정은 조직 계정을 관리한 다음 해당 조직의 사용자 그룹 및 위치 그룹에 대한 권한을 얻을 수 있습니다. 그런 다음 개인 계정은 연결된 위치 그룹을 통해 위치와 비즈니스 정보를 관리할 수 있습니다.

개인 계정

개인 계정은 Google 계정을 만들면 자동으로 사용할 수 있습니다. 개인 계정은 비즈니스 정보의 소유자 및 관리자가 될 수 있습니다.

조직 계정

조직 계정대행사를 나타내는 상위 계정입니다. 위치 그룹 및 사용자 그룹이 조직 계정에 저장되며 조직의 모든 구성원이 그룹에 액세스할 수 있습니다. 위치는 여러 조직에 속할 수 있습니다.

API를 사용하면 accounts.admins.create 메서드로 개인 계정을 초대하여 조직 계정을 관리하거나 소유하도록 할 수 있습니다.

위치 그룹 계정

위치 그룹은 개별 위치 그룹을 관리하는 데 사용됩니다. 위치 그룹을 사용하여 여러 위치에 일괄 작업을 실행할 수 있습니다. 위치 그룹에 개인 계정 및 사용자 그룹을 추가하면 위치 그룹의 권한이 상속됩니다.

위치 그룹을 만들어 체인, 지역 또는 카테고리별로 위치를 분류할 수도 있습니다. 위치는 한 번에 여러 위치 그룹에 포함될 수 있습니다.

My Business Account Management API를 사용하면 accounts.create 메서드로 위치 그룹을 만들고 위치 그룹으로 위치를 이전할 수 있습니다. 또한 위치 그룹을 관리하도록 개인 계정을 초대할 수도 있습니다. 사용자 그룹은 웹 인터페이스에서 위치 그룹에 직접 추가할 수 있습니다.

사용자 그룹 계정

대규모로 권한을 관리하려면 사용자 그룹을 사용하세요. 개인 계정을 사용자 그룹에 추가할 수 있습니다. 그런 다음 사용자 그룹에 조직의 여러 위치 그룹에 대한 관리 액세스 권한을 부여할 수 있습니다. 이제 사용자 그룹의 모든 개인 계정에서 위치 그룹 아래의 위치에 대해 관리 작업을 실행할 수 있습니다.

예를 들어 새 구성원이 운영팀에 합류하면 해당 구성원을 사용자 그룹에 직접 추가할 수 있으며 구성원은 동료가 액세스할 수 있는 모든 위치에 즉시 액세스할 수 있습니다. 사용자에게 각 위치에 대한 액세스 권한을 부여하는 데 더 시간이 걸리며 이러한 방식으로 관리하기가 더 어렵습니다.

My Business Account Management API를 사용하면 accounts.create 메서드로 사용자 그룹을 만들 수 있습니다. 또한 계정 및 위치의 관리자를 관리하도록 개인 계정을 초대할 수도 있습니다.

API를 사용하여 모든 계정 목록 호출

액세스 권한이 있는 모든 계정 및 연결된 계정 유형을 표시하려면 OAuth 사용자 인증 정보를 사용하여 accounts.list 메서드를 호출하세요. 응답에는 모든 계정, name 필드에 있는 계정 ID, 계정 유형이 포함됩니다.

요청

다음은 accounts.list 요청의 예입니다.

HTTP
GET
https://mybusinessaccountmanagement.googleapis.com/v1/accounts
Authorization: Bearer <access_token>

응답

다음은 accounts.list 응답의 예입니다.

{
    "accounts": [
        {
            "name": "accounts/{accountId}",
            "accountName": "John Doe",
            "type": "PERSONAL",
            "state": {
                "status": "UNVERIFIED"
            },
            "profilePhotoUrl": "//lh5.googleusercontent.com/REDACTED"
        },
        {
            "name": "accounts/{accountId}",
            "accountName": "John Doe’s Location Group",
            "type": "LOCATION_GROUP",
            "role": "OWNER",
            "state": {
                "status": "UNVERIFIED"
            },
            "accountNumber": "{accountNumber}",
            "permissionLevel": "OWNER_LEVEL"
        }
    ]
}

이 가이드에 설명된 모든 계정 유형이 accounts.list 요청에 대한 응답에 포함될 수 있습니다. 계정 목록을 검토하고 관리할 위치에 대한 액세스 권한이 있는 특정 계정을 확인하세요. 그런 다음 특정 계정의 name 필드로 accounts.locations.list를 호출하여 해당 계정에서 액세스할 수 있는 위치 목록을 가져옵니다.

예를 들어 '홍길동의 위치 그룹'에 속하는 모든 위치를 가져오려면 다음과 같이 요청하세요.

HTTP
GET
https://mybusinessbusinessinformation.googleapis.com/v1/{accountId}/locations
Authorization: Bearer <access_token>

응답은 다음과 같이 사용자가 액세스할 수 있는 위치 목록을 반환합니다.

{
    "locations": [
        {
            "name": "locations/{locationId}",
            "locationName": "Test Business",
            ...
        },
        {
            "name": "locations/{locationId}",
            "locationName": "2nd Test Business",
            ...
         }
     ]
}

위치 관리 다이어그램

다음 다이어그램은 다음과 같은 사실을 보여줍니다.

  • 조직에 여러 사용자 그룹이 포함될 수 있습니다.
  • 사용자 그룹에서 여러 위치 그룹을 관리할 수 있습니다.
  • 위치 그룹에 여러 위치가 포함될 수 있습니다.
  • 위치가 조직 전체의 여러 위치 그룹에 걸쳐 있을 수 있습니다.
위치 관리 계층구조
그림 1. 위치 관리 계층구조