REST Resource: accounts

리소스: Account

계정은 위치의 컨테이너입니다. 비즈니스의 위치를 관리하는 유일한 사용자인 경우 개인 Google 계정을 사용할 수 있습니다. 여러 사용자와 공동으로 위치를 관리하려면 비즈니스 계정을 만드세요.

JSON 표현 
{
  "name": string,
  "accountName": string,
  "primaryOwner": string,
  "type": enum (AccountType),
  "role": enum (AccountRole),
  "verificationState": enum (VerificationState),
  "vettedState": enum (VettedState),
  "accountNumber": string,
  "permissionLevel": enum (PermissionLevel),
  "organizationInfo": {
    object (OrganizationInfo)
  }
}
필드
name

string

변경할 수 없습니다. accounts/{account_id} 형식의 리소스 이름입니다.
accountName

string

필수 항목입니다. 계정의 이름입니다. PERSONAL 유형의 계정의 경우 사용자 계정의 성과 이름입니다.
primaryOwner

string

필수 항목입니다. 입력 전용. 생성 중인 계정의 기본 소유자가 될 계정의 리소스 이름입니다. accounts/{account_id} 형식이어야 합니다.
type

enum (AccountType)

필수 항목입니다. 계정 유형이 포함됩니다. PERSONAL 및 ORG 유형의 계정은 이 API를 사용하여 만들 수 없습니다.
role

enum (AccountRole)

출력 전용. 이 계정의 AccountRole을 지정합니다.
verificationState

enum (VerificationState)

출력 전용. 인증을 받으면 향후 만들어지는 위치는 자동으로 Google 지도에 연결되고, 검토 없이도 Google+ 페이지가 생성됩니다.
vettedState

enum (VettedState)

출력 전용. Google에서 계정을 심사했는지 여부를 나타냅니다. 검증된 계정은 VETTED_PARTNER 메서드를 통해 위치를 인증할 수 있습니다.
accountNumber

string

출력 전용. 계정 참조 번호(프로비저닝된 경우)
permissionLevel

enum (PermissionLevel)

출력 전용. 사용자가 이 계정에 대해 갖는 권한 수준을 지정합니다.
organizationInfo

object (OrganizationInfo)

출력 전용. 조직의 추가 정보입니다. 조직 계정의 경우에만 채워집니다.

AccountType

계정의 종류를 나타냅니다(개인/사용자 계정 또는 비즈니스 계정).

열거형
ACCOUNT_TYPE_UNSPECIFIED 지정되지 않음
PERSONAL 최종 사용자 계정.
LOCATION_GROUP 위치 그룹입니다. 자세한 내용은 고객센터 도움말을 참고하세요.
USER_GROUP 그룹으로 조직 직원을 분리하는 사용자 그룹 자세한 내용은 고객센터 도움말을 참고하세요.
ORGANIZATION 회사를 대표하는 조직입니다. 자세한 내용은 고객센터 도움말을 참고하세요.

AccountRole

인증된 사용자가 이 계정에 대해 갖는 액세스 수준을 나타냅니다. 자세한 내용은 고객센터 도움말을 참고하세요.

열거형
ACCOUNT_ROLE_UNSPECIFIED 지정되지 않음
PRIMARY_OWNER 사용자가 이 계정의 기본 소유자입니다.
OWNER 계정의 사용자 소유자입니다.
MANAGER 사용자가 이 계정을 관리할 수 있습니다.
SITE_MANAGER 사용자가 계정에서 관리할 수 있는 일부 기능만 관리할 수 있습니다.

VerificationState

계정의 확인 상태를 나타냅니다.

열거형
VERIFICATION_STATE_UNSPECIFIED 지정되지 않음
VERIFIED 인증된 계정입니다.
UNVERIFIED 계정이 인증되지 않았으며, 인증이 요청되지 않았습니다.
VERIFICATION_REQUESTED 인증이 요청되었으나 인증이 필요한 계정입니다.

VettedState

계정의 심사 상태를 나타냅니다.

열거형
VETTED_STATE_UNSPECIFIED 지정되지 않음
NOT_VETTED Google에서 계정을 심사하지 않았습니다.
VETTED 계정이 Google의 심사를 거쳤으며 유효한 상태입니다. 심사를 마친 그룹 계정에 직접 액세스할 수 있는 계정은 자동으로 심사됩니다.
INVALID 계정이 검토되었지만 잘못된 상태입니다. 이 계정은 검증되지 않은 계정처럼 작동합니다.

PermissionLevel

인증된 사용자가 이 계정에 대해 갖는 액세스 수준을 나타냅니다.

열거형
PERMISSION_LEVEL_UNSPECIFIED 지정되지 않음
OWNER_LEVEL 사용자에게 소유자 수준의 권한이 있습니다.
MEMBER_LEVEL 사용자에게 회원 수준 권한이 있습니다.

OrganizationInfo

조직에 대해 저장된 추가 정보입니다.

JSON 표현 
{
  "registeredDomain": string,
  "address": {
    object (PostalAddress)
  },
  "phoneNumber": string
}
필드
registeredDomain

string

출력 전용. 계정에 등록된 도메인입니다.
address

object (PostalAddress)

출력 전용. 계정의 우편 주소입니다.
phoneNumber

string

출력 전용. 조직의 연락처 번호입니다.

PostalAddress

우편 배달 또는 수취인 주소와 같은 우편 주소를 나타냅니다. 우편 주소가 있으면 우편 서비스가 사업장, 사서함 또는 이와 유사한 주소로 물건을 배송할 수 있습니다. 도로, 마을, 산 등 지리적 위치를 모델링하기 위한 것은 아닙니다.

일반적인 용도에서는 프로세스 유형에 따라 사용자 입력을 통해 또는 기존 데이터를 가져와 주소가 생성됩니다.

주소 입력 / 수정 관련 조언: - 국제화가 가능한 주소 위젯(예: https://github.com/google/libaddressinput) 사용 - 해당 입력란이 사용되는 국가 이외의 지역에서 입력란을 입력하거나 수정할 수 있는 UI 요소가 사용자에게 제공되어서는 안 됩니다.

이 스키마를 사용하는 방법에 대한 자세한 안내는 https://support.google.com/business/answer/6397478을 참조하세요.

JSON 표현 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
필드
revision

integer

PostalAddress의 스키마 버전입니다. 최신 버전인 0으로 설정해야 합니다.

모든 새 버전은 이전 버전과 반드시 호환되어야 합니다.
regionCode

string

필수 항목입니다. 주소의 국가/지역에 해당하는 CLDR 지역 코드입니다. 이는 추론되지 않으며 값이 올바른지 확인하는 것은 사용자의 책임입니다. 자세한 내용은 https://cldr.unicode.org/ 및 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참고하세요. 예: 스위스의 경우 'CH'.
languageCode

string

선택사항입니다. 이 주소 콘텐츠의 BCP-47 언어 코드입니다 (알려진 경우). 주로 입력 양식의 UI 언어이거나 주소의 국가/지역에서 사용되는 언어 중 하나 또는 음역된 언어와 일치해야 합니다. 이는 특정 국가에서 형식에 영향을 줄 수 있지만 데이터의 정확성에는 중요하지 않으며 유효성 검사 또는 기타 형식 지정과 관련 없는 작업에는 영향을 미치지 않습니다.

이 값을 알 수 없는 경우 잘못되었을 수 있는 기본값을 지정하는 대신 이 값을 생략해야 합니다.

예: 'zh-Hant', 'ja', 'ja-Latn', 'en'.
postalCode

string

선택사항입니다. 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 우편번호를 필수로 사용해야 하는 것은 아니지만, 우편번호가 사용되는 경우 주소의 다른 부분에서 추가 확인 (예: 미국의 주/우편번호 확인)이 트리거될 수 있습니다.
sortingCode

string

선택사항입니다. 국가별 추가 정렬 코드입니다. 대부분의 리전에서 사용되지 않습니다. 사용되는 경우 값은 선택적으로 뒤에 숫자가 오는 'CEDEX'와 같은 문자열 (예: 'CEDEX 7')이거나 '섹터 코드' (자메이카), '배송 지역 표시기' (말라위) 또는 '우체국 표시기' (예: 코트디부아르)를 나타내는 숫자만 있습니다.
administrativeArea

string

선택사항입니다. 국가 또는 지역의 우편 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 시/도, 주 또는 현이 될 수 있습니다. 특히 스페인의 경우 자치 공동체가 아닌 주입니다 (예: '카탈로니아'가 아니라 '바르셀로나'). 많은 국가에서 우편 주소에 행정 구역을 사용하지 않습니다. 예를 들어 스위스에서는 이 필드를 채우지 않은 상태로 두어야 합니다.
locality

string

선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 도시, IT 코뮌, 영국 우체국 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 지역을 비워 두고 addressLines를 사용합니다.
sublocality

string

선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구, 지구가 여기에 해당합니다.
addressLines[]

string

주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다.

addressLines의 값에는 유형 정보가 없고 경우에 따라 단일 필드에 여러 값이 포함될 수 있으므로 (예: 'Austin, TX') 행 순서가 명확해야 합니다. 주소 입력란 순서는 주소의 국가/지역의 '봉투 순서'여야 합니다. 다양한 지역 (예: 일본)에서는 address_language를 사용하여 명시적으로 만듭니다 (예: 큰 대 작은 순서의 경우 'ja', 크고 작은 순서의 경우 'ja-Latn' 또는 'en'). 이렇게 하면 언어에 따라 가장 구체적인 주소 입력란을 선택할 수 있습니다.

주소에 허용되는 최소 구조 표현은 나머지 모든 정보가 addressLines에 배치된 regionCode로 구성됩니다. 이러한 주소의 형식은 지오코딩 없이 매우 대략적으로만 가능하지만, 최소한 부분적으로 해결될 때까지는 어떤 주소 구성 요소도 의미적 추론을 할 수 없습니다.

(주소의 어떤 부분이 지역인지 또는 행정 구역이어야 하는지 추측하는 대신) regionCode와 addressLines만 포함된 주소를 만든 다음 지오코딩하는 것이 완전히 구조화되지 않은 주소를 처리하는 권장 방법입니다.
recipients[]

string

선택사항입니다. 주소의 수신자입니다. 경우에 따라 이 필드에는 여러 줄의 정보가 포함될 수 있습니다. 예를 들어 '돌봄' 정보가 포함될 수 있습니다.
organization

string

선택사항입니다. 주소에 있는 조직의 이름입니다.

방법

create

 지정된 상위 항목에 지정된 이름과 유형의 계정을 만듭니다.

get

 지정된 계정을 가져옵니다.

list

 인증된 사용자의 모든 계정을 나열합니다.

patch

 지정된 비즈니스 계정을 업데이트합니다.