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 및 ORGANIZATION 유형의 계정은 이 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

우편 주소를 나타냅니다. 예: 우편번호를 입력하세요. 우편 주소가 주어지면 우편 서비스는 사업장(P.O. Box 또는 이와 유사한 제품 도로, 마을, 산 등 지리적 위치를 모델링하기 위한 것이 아닙니다.

일반적으로 주소는 프로세스 유형에 따라 사용자 입력을 통해 또는 기존 데이터 가져오기를 통해 만들어집니다.

주소 입력 / 수정에 관한 조언: - 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

선택사항입니다. 주소의 수신자입니다. 경우에 따라 이 필드에 여러 줄의 정보가 포함될 수 있습니다. 예를 들어 'care of'라는 단어와 확인할 수 있습니다

organization

string

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

메서드

create

특정 상위 계정 아래에 지정된 이름과 유형으로 계정을 만듭니다.

get

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

list

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

patch

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