REST Resource: customers

리소스: Customer

Google 고객 계정이 리셀러에 등록되면 이 리셀러가 Google 서비스에 대한 고객의 구독을 관리합니다. 고객은 기본 도메인 이름과 실제 주소로 설명됩니다.

JSON 표현
{
  "customerId": string,
  "customerDomain": string,
  "postalAddress": {
    object (Address)
  },
  "phoneNumber": string,
  "alternateEmail": string,
  "resourceUiUrl": string,
  "customerDomainVerified": boolean,
  "kind": string,
  "customerType": enum (CustomerType),
  "primaryAdmin": {
    object (PrimaryAdmin)
  }
}
필드
customerId

string

이 속성은 항상 Google에서 생성된 고유 식별자로 반환됩니다. 요청에서 이 속성은 기본 도메인일 수도 있고 Google에서 생성된 고유 식별자일 수도 있습니다.

customerDomain

string

고객의 기본 도메인 이름 문자열입니다. 신규 고객을 만들려면 customerDomain이 필요합니다. 고객을 추가할 때 도메인에 www 접두어를 포함하지 않습니다.

postalAddress

object (Address)

고객의 주소 정보입니다. 각 입력란의 글자 수는 255자(영문 기준)로 제한됩니다.

phoneNumber

string

고객 연락처 전화번호 '+'로 시작하고 뒤에 국가 코드가 와야 합니다. 나머지 번호는 연속된 숫자이거나 전화 지역 형식 규칙을 따를 수 있지만 실제 전화번호여야 하며 '123"가 아니어야 합니다. 이 필드는 유효하지 않으면 자동으로 무시됩니다.

alternateEmail

string

리셀러 도구의 '고객 이메일'과 마찬가지로 이 이메일은 서비스 중단 또는 보안 문제 등 고객 서비스에 문제가 발생할 경우 사용되는 보조 연락처입니다. 이 속성은 신규 '도메인' 고객을 만들 때 필요하며 customerDomain과(와) 동일한 도메인을 사용해서는 안 됩니다. alternateEmail 필드는 '팀' 고객을 만드는 데 필요하지 않습니다.

resourceUiUrl

string

고객의 관리 콘솔 대시보드 URL입니다. 읽기 전용 URL은 API 서비스에 의해 생성됩니다. 클라이언트 애플리케이션에 고객이 관리 콘솔에서 작업을 완료해야 하는 경우에 사용됩니다.

customerDomainVerified

boolean

고객의 기본 도메인이 확인되었는지 여부입니다.

kind

string

리소스를 고객으로 식별합니다. 값: reseller#customer

customerType

enum (CustomerType)

고객의 유형을 식별합니다. 사용 가능한 값은 다음과 같습니다.

  • domain: 도메인 인증 고객 (기본값)을 암시합니다.
  • team: 이메일 인증 고객을 암시합니다.

자세한 내용은 관리팀을 참고하세요.

primaryAdmin

object (PrimaryAdmin)

고객의 첫 번째 관리 세부정보로, TEAM 고객의 경우 표시됩니다.

주소

고객 주소의 JSON 템플릿입니다.

JSON 표현
{
  "countryCode": string,
  "kind": string,
  "region": string,
  "addressLine2": string,
  "locality": string,
  "addressLine3": string,
  "postalCode": string,
  "addressLine1": string,
  "organizationName": string,
  "contactName": string
}
필드
countryCode

string

countryCode 정보는 ISO 3166 국가 코드 요소를 참고하세요. 국가가 Google 제품 재판매에 대해 승인되었는지 확인합니다. 신규 고객을 생성할 때 이 속성이 필요합니다.

kind

string

리소스를 고객 주소로 식별합니다. 값: customers#address

region

string

region 값의 예시는 캘리포니아 주의 CA입니다.

addressLine2

string

주소의 두 번째 줄입니다.

locality

string

locality 값의 예는 San Francisco입니다.

addressLine3

string

주소의 3번째 행입니다.

postalCode

string

postalCode의 예는 94043와 같은 우편번호입니다. 신규 고객을 생성할 때 이 속성이 필요합니다.

addressLine1

string

고객의 실제 주소입니다. 주소는 1~3줄로 구성될 수 있습니다. addressline2addressLine3는 선택사항입니다.

organizationName

string

회사 또는 회사 부서 이름입니다. 필수 항목입니다.

contactName

string

고객 연락처의 이름입니다. 필수 항목입니다.

고객 유형

고객 유형

열거형
customerTypeUnspecified 알 수 없는 고객 유형
domain 도메인 또는 도메인 소유 고객
team 도메인 또는 이메일 인증 고객

기본 관리자

TEAM 고객의 경우 기본 관리자를 위한 JSON 템플릿

JSON 표현
{
  "primaryEmail": string
}
필드
primaryEmail

string

고객 기본 관리자의 비즈니스 이메일

이메일 확인 링크는 고객 생성 시 이 이메일 주소로 전송됩니다. 기본 관리자는 사용자를 초대 및 삭제하고 고객의 관리 요구사항을 관리하는 기능을 비롯하여 고객의 관리 콘솔에 액세스할 수 있습니다.

방법

get

고객 계정을 가져옵니다.

insert

신규 고객 계정을 주문합니다.

patch

고객 계정 설정 업데이트

update

고객 계정 설정 업데이트