REST Resource: customers

리소스: 고객

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

주소의 세 번째 줄입니다.

postalCode

string

postalCode의 예는 94043와 같은 우편번호입니다. 이 속성은 새 고객을 만들 때 필요합니다.

addressLine1

string

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

organizationName

string

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

contactName

string

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

CustomerType

고객 유형

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

PrimaryAdmin

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

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

string

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

고객을 만들 때 이 이메일 주소로 이메일 인증 링크가 전송됩니다. 기본 관리자는 사용자를 초대 및 퇴거하고 고객의 관리 요구사항을 관리하는 기능을 비롯하여 고객의 관리 콘솔에 액세스할 수 있습니다.

메서드

get

고객 계정을 가져옵니다.

insert

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

patch

고객 계정의 설정을 업데이트합니다.

update

고객 계정의 설정을 업데이트합니다.