REST Resource: customers
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: 고객
JSON 표현 |
{
"id": string,
"customerDomain": string,
"kind": string,
"etag": string,
"alternateEmail": string,
"customerCreationTime": string,
"postalAddress": {
object (CustomerPostalAddress )
},
"phoneNumber": string,
"language": string
} |
필드 |
id |
string
고객의 Google Workspace 계정의 고유 ID입니다. (읽기 전용)
|
customerDomain |
string
고객의 기본 도메인 이름 문자열입니다. 새 고객을 만들 때 www 접두어를 포함하지 않습니다.
|
kind |
string
리소스를 고객으로 식별합니다. 값: admin#directory#customer
|
etag |
string
리소스의 ETag입니다.
|
alternateEmail |
string
고객의 보조 연락처 이메일 주소입니다. 이 이메일 주소는 customerDomain 와 동일한 도메인에 있을 수 없습니다.
|
customerCreationTime |
string
고객 생성 시간 (읽기 전용)
|
postalAddress |
object (CustomerPostalAddress )
고객의 우편 주소 정보입니다.
|
phoneNumber |
string
고객의 연락처 전화번호(E.164 형식)입니다.
|
language |
string
고객의 ISO 639-2 언어 코드입니다. 지원되는 코드 목록은 언어 코드 페이지를 참고하세요. 지원되는 세트 외부의 유효한 언어 코드는 API에서 허용되지만 예기치 않은 동작이 발생할 수 있습니다. 기본값은 en 입니다.
|
CustomerPostalAddress
JSON 표현 |
{
"countryCode": string,
"addressLine2": string,
"region": string,
"addressLine3": string,
"locality": string,
"postalCode": string,
"addressLine1": string,
"organizationName": string,
"contactName": string
} |
필드 |
countryCode |
string
필수 속성입니다. countryCode 정보는 ISO 3166 국가 코드 요소를 참고하세요.
|
addressLine2 |
string
주소의 두 번째 줄입니다.
|
region |
string
지역의 이름 지역 값의 예로는 뉴욕주의 경우 NY 이 있습니다.
|
addressLine3 |
string
주소의 세 번째 줄입니다.
|
locality |
string
지역의 이름입니다. 지역 값의 예는 San Francisco 시입니다.
|
postalCode |
string
우편번호입니다. postalCode의 예는 10009 와 같은 우편번호입니다. 이는 http: //portablecontacts.net/draft-spec.html#address_element에 따른 것입니다.
|
addressLine1 |
string
고객의 실제 주소입니다. 주소는 1~3줄로 구성할 수 있습니다.
|
organizationName |
string
회사 또는 회사 부서 이름입니다.
|
contactName |
string
고객 연락처의 이름입니다.
|
메서드 |
|
고객을 검색합니다. |
|
고객을 패치합니다. |
|
고객을 업데이트합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-24(UTC)
[null,null,["최종 업데이트: 2025-07-24(UTC)"],[],[],null,["# REST Resource: customers\n\nResource: Customer\n------------------\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"customerDomain\": string, \"kind\": string, \"etag\": string, \"alternateEmail\": string, \"customerCreationTime\": string, \"postalAddress\": { object (/workspace/admin/directory/reference/rest/v1/customers#CustomerPostalAddress) }, \"phoneNumber\": string, \"language\": string } ``` |\n\n| Fields ||\n|------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` The unique ID for the customer's Google Workspace account. (Readonly) |\n| `customerDomain` | `string` The customer's primary domain name string. Do not include the `www` prefix when creating a new customer. |\n| `kind` | `string` Identifies the resource as a customer. Value: `admin#directory#customer` |\n| `etag` | `string` ETag of the resource. |\n| `alternateEmail` | `string` The customer's secondary contact email address. This email address cannot be on the same domain as the `customerDomain` |\n| `customerCreationTime` | `string` The customer's creation time (Readonly) |\n| `postalAddress` | `object (`[CustomerPostalAddress](/workspace/admin/directory/reference/rest/v1/customers#CustomerPostalAddress)`)` The customer's postal address information. |\n| `phoneNumber` | `string` The customer's contact phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format. |\n| `language` | `string` The customer's ISO 639-2 language code. See the [Language Codes](https://developers.google.com/workspace/admin/directory/v1/languages) page for the list of supported codes. Valid language codes outside the supported set will be accepted by the API but may lead to unexpected behavior. The default value is `en`. |\n\nCustomerPostalAddress\n---------------------\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"countryCode\": string, \"addressLine2\": string, \"region\": string, \"addressLine3\": string, \"locality\": string, \"postalCode\": string, \"addressLine1\": string, \"organizationName\": string, \"contactName\": string } ``` |\n\n| Fields ||\n|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `countryCode` | `string` This is a required property. For `countryCode` information see the [ISO 3166 country code elements](https://www.iso.org/iso/country_codes.htm). |\n| `addressLine2` | `string` Address line 2 of the address. |\n| `region` | `string` Name of the region. An example of a region value is `NY` for the state of New York. |\n| `addressLine3` | `string` Address line 3 of the address. |\n| `locality` | `string` Name of the locality. An example of a locality value is the city of `San Francisco`. |\n| `postalCode` | `string` The postal code. A postalCode example is a postal zip code such as `10009`. This is in accordance with - http: //portablecontacts.net/draft-spec.html#address_element. |\n| `addressLine1` | `string` A customer's physical address. The address can be composed of one to three lines. |\n| `organizationName` | `string` The company or company division name. |\n| `contactName` | `string` The customer contact's name. |\n\n| Methods ------- ||\n|-----------------------------------------------------------------------------|-----------------------|\n| ### [get](/workspace/admin/directory/reference/rest/v1/customers/get) | Retrieves a customer. |\n| ### [patch](/workspace/admin/directory/reference/rest/v1/customers/patch) | Patches a customer. |\n| ### [update](/workspace/admin/directory/reference/rest/v1/customers/update) | Updates a customer. |"]]