- 리소스: Account
- AccountType
- AccountRole
- VerificationState
- VettedState
- PermissionLevel
- OrganizationInfo
- PostalAddress
- 메서드
리소스: Account
계정은 위치의 컨테이너입니다. 비즈니스의 위치를 관리하는 유일한 사용자인 경우 개인 Google 계정을 사용할 수 있습니다. 여러 사용자와 공동으로 위치를 관리하려면 비즈니스 계정을 만드세요.
JSON 표현 |
---|
{ "name": string, "accountName": string, "primaryOwner": string, "type": enum ( |
필드 | |
---|---|
name |
변경할 수 없습니다. |
accountName |
필수 항목입니다. 계정의 이름입니다. |
primaryOwner |
필수 항목입니다. 입력 전용. 생성 중인 계정의 기본 소유자가 될 계정의 리소스 이름입니다. |
type |
필수 항목입니다. 계정 유형이 포함됩니다. PERSONAL 및 ORG 유형의 계정은 이 API를 사용하여 만들 수 없습니다. |
role |
출력 전용. 이 계정의 AccountRole을 지정합니다. |
verificationState |
출력 전용. 인증을 받으면 향후 만들어지는 위치는 자동으로 Google 지도에 연결되고, 검토 없이도 Google+ 페이지가 생성됩니다. |
vettedState |
출력 전용. Google에서 계정을 심사했는지 여부를 나타냅니다. 검증된 계정은 VETTED_PARTNER 메서드를 통해 위치를 인증할 수 있습니다. |
accountNumber |
출력 전용. 계정 참조 번호(프로비저닝된 경우) |
permissionLevel |
출력 전용. 사용자가 이 계정에 대해 갖는 권한 수준을 지정합니다. |
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 ( |
필드 | |
---|---|
registeredDomain |
출력 전용. 계정에 등록된 도메인입니다. |
address |
출력 전용. 계정의 우편 주소입니다. |
phoneNumber |
출력 전용. 조직의 연락처 번호입니다. |
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 |
모든 새 버전은 이전 버전과 반드시 호환되어야 합니다. |
regionCode |
필수 항목입니다. 주소의 국가/지역에 해당하는 CLDR 지역 코드입니다. 이는 추론되지 않으며 값이 올바른지 확인하는 것은 사용자의 책임입니다. 자세한 내용은 https://cldr.unicode.org/ 및 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html을 참고하세요. 예: 스위스의 경우 'CH'. |
languageCode |
선택사항입니다. 이 주소 콘텐츠의 BCP-47 언어 코드입니다 (알려진 경우). 주로 입력 양식의 UI 언어이거나 주소의 국가/지역에서 사용되는 언어 중 하나 또는 음역된 언어와 일치해야 합니다. 이는 특정 국가에서 형식에 영향을 줄 수 있지만 데이터의 정확성에는 중요하지 않으며 유효성 검사 또는 기타 형식 지정과 관련 없는 작업에는 영향을 미치지 않습니다. 이 값을 알 수 없는 경우 잘못되었을 수 있는 기본값을 지정하는 대신 이 값을 생략해야 합니다. 예: 'zh-Hant', 'ja', 'ja-Latn', 'en'. |
postalCode |
선택사항입니다. 주소의 우편번호입니다. 모든 국가에서 우편번호를 사용하거나 우편번호를 필수로 사용해야 하는 것은 아니지만, 우편번호가 사용되는 경우 주소의 다른 부분에서 추가 확인 (예: 미국의 주/우편번호 확인)이 트리거될 수 있습니다. |
sortingCode |
선택사항입니다. 국가별 추가 정렬 코드입니다. 대부분의 리전에서 사용되지 않습니다. 사용되는 경우 값은 선택적으로 뒤에 숫자가 오는 'CEDEX'와 같은 문자열 (예: 'CEDEX 7')이거나 '섹터 코드' (자메이카), '배송 지역 표시기' (말라위) 또는 '우체국 표시기' (예: 코트디부아르)를 나타내는 숫자만 있습니다. |
administrativeArea |
선택사항입니다. 국가 또는 지역의 우편 주소에 사용되는 최상위 행정 구역 단위입니다. 예를 들어 시/도, 주 또는 현이 될 수 있습니다. 특히 스페인의 경우 자치 공동체가 아닌 주입니다 (예: '카탈로니아'가 아니라 '바르셀로나'). 많은 국가에서 우편 주소에 행정 구역을 사용하지 않습니다. 예를 들어 스위스에서는 이 필드를 채우지 않은 상태로 두어야 합니다. |
locality |
선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 도시, IT 코뮌, 영국 우체국 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 지역을 비워 두고 addressLines를 사용합니다. |
sublocality |
선택사항입니다. 주소의 하위 지역입니다. 예를 들어 인근 지역, 자치구, 지구가 여기에 해당합니다. |
addressLines[] |
주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다. addressLines의 값에는 유형 정보가 없고 경우에 따라 단일 필드에 여러 값이 포함될 수 있으므로 (예: 'Austin, TX') 행 순서가 명확해야 합니다. 주소 입력란 순서는 주소의 국가/지역의 '봉투 순서'여야 합니다. 다양한 지역 (예: 일본)에서는 address_language를 사용하여 명시적으로 만듭니다 (예: 큰 대 작은 순서의 경우 'ja', 크고 작은 순서의 경우 'ja-Latn' 또는 'en'). 이렇게 하면 언어에 따라 가장 구체적인 주소 입력란을 선택할 수 있습니다. 주소에 허용되는 최소 구조 표현은 나머지 모든 정보가 addressLines에 배치된 regionCode로 구성됩니다. 이러한 주소의 형식은 지오코딩 없이 매우 대략적으로만 가능하지만, 최소한 부분적으로 해결될 때까지는 어떤 주소 구성 요소도 의미적 추론을 할 수 없습니다. (주소의 어떤 부분이 지역인지 또는 행정 구역이어야 하는지 추측하는 대신) regionCode와 addressLines만 포함된 주소를 만든 다음 지오코딩하는 것이 완전히 구조화되지 않은 주소를 처리하는 권장 방법입니다. |
recipients[] |
선택사항입니다. 주소의 수신자입니다. 경우에 따라 이 필드에는 여러 줄의 정보가 포함될 수 있습니다. 예를 들어 '돌봄' 정보가 포함될 수 있습니다. |
organization |
선택사항입니다. 주소에 있는 조직의 이름입니다. |
방법 |
|
---|---|
|
지정된 상위 항목에 지정된 이름과 유형의 계정을 만듭니다. |
|
지정된 계정을 가져옵니다. |
|
인증된 사용자의 모든 계정을 나열합니다. |
|
지정된 비즈니스 계정을 업데이트합니다. |