REST Resource: accounts

{
  "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)
  }
}

string

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

string

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

string

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

enum (AccountType)

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

enum (AccountRole)

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

enum (VerificationState)

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

enum (VettedState)

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

string

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

enum (PermissionLevel)

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

object (OrganizationInfo)

출력 전용입니다. 조직에 대한 추가 정보입니다. 조직 계정에 대해서만 채워집니다.

{
  "registeredDomain": string,
  "address": {
    object (PostalAddress)
  },
  "phoneNumber": string
}

string

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

object (PostalAddress)

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

string

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

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

integer

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

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

string

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

string

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

이 값을 알 수 없는 경우, 잘못될 가능성이 있는 기본값을 지정하는 대신 이 값을 생략해야 합니다.

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

string

선택사항입니다. 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 표시해야 하는 것은 아니지만, 우편번호가 사용되는 지역에서는 주소의 다른 부분에 대한 추가 유효성 검사 (예: 미국의 주/우편번호 유효성 검사)가 트리거될 수 있습니다.

string

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

string

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

string

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

string

선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구, 구역이 될 수 있습니다.

string

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

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

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

지역 또는 행정 구역에 해당하는 부분을 추측하는 대신, regionCode와 addressLines만 포함된 주소를 만든 다음 지오코딩을 사용하여 완전히 구조화되지 않은 주소를 처리하는 것이 좋습니다.

string

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

string

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