REST Resource: partners.customers

리소스: Company

제로터치 리셀러 및 고객 API의 리셀러, 공급업체 또는 고객

JSON 표현 
{
  "name": string,
  "companyId": string,
  "companyName": string,
  "ownerEmails": [
    string
  ],
  "adminEmails": [
    string
  ],
  "termsStatus": enum (TermsStatus),
  "skipWelcomeEmail": boolean,
  "languageCode": string,
  "googleWorkspaceAccount": {
    object (GoogleWorkspaceAccount)
  }
}
필드
name

string

출력 전용. 회사의 API 리소스 이름입니다. 리소스 이름은 다음 형식 중 하나입니다.

  • partners/[PARTNER_ID]/customers/[CUSTOMER_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]

서버에서 할당됩니다.
companyId

string (int64 format)

출력 전용. 회사의 ID입니다. 서버에서 할당됩니다.
companyName

string

필수 항목입니다. 회사 이름입니다. 예: XYZ Corp. 제로터치 등록 포털에서 회사 직원에게 표시됩니다.
ownerEmails[]

string

필수 항목입니다. 입력 전용. 소유자 역할의 고객 사용자 이메일 주소입니다. owner_email가 1개 이상 필요합니다. 소유자는 관리자와 동일한 액세스 권한을 공유하지만 조직의 포털 사용자를 추가, 삭제, 수정할 수도 있습니다.
adminEmails[]

string

선택사항. 관리자 역할에 있는 고객 사용자의 이메일 주소입니다. 각 이메일 주소는 Google 계정과 연결되어 있어야 합니다.
termsStatus

enum (TermsStatus)

출력 전용. 회사의 모든 사용자가 최신 서비스 약관 (ToS)에 동의했는지 여부입니다. TermsStatus 페이지를 참고하세요.
skipWelcomeEmail

boolean

입력 전용. true로 설정하면 고객에게 환영 이메일이 전송되지 않습니다. 고객이 기기 신청 시 별도의 이메일을 받게 되므로, 추가 DEVICE_PROTECTION 서비스를 통해 기기의 소유권을 주장할 경우 환영 이메일을 건너뛰는 것이 좋습니다. 제로터치 고객이 아닌 경우 이 필드는 무시됩니다.
languageCode

string

입력 전용. BCP47 언어 코드로 표시되는 고객의 기본 언어입니다. 이 필드는 입력 시 검증되며 지원되지 않는 언어 코드가 포함된 요청은 거부됩니다. 지원되는 언어 코드: 아랍어(ar) 중국어(홍콩)(zh-HK) 중국어(간체) 한국어(북)
googleWorkspaceAccount

object (GoogleWorkspaceAccount)

출력 전용. 이 고객과 연결된 Google Workspace 계정입니다. 고객 회사에만 사용됩니다.

약관 상태

제로터치 등록 서비스 약관 (ToS)에 동의한 기업 한 명의 사용자가 웹 포털을 사용하여 회사의 서비스 약관에 동의할 수 있습니다.

서비스 약관에는 버전이 지정되어 있습니다. 서비스 약관이 변경되면 1명 이상의 사용자가 새 서비스 약관에 동의해야 합니다. 첫 번째 사용자가 새 서비스 약관에 동의할 때까지 회사의 약관 상태는 TERMS_STATUS_STALE입니다.

열거형
TERMS_STATUS_NOT_ACCEPTED 이 회사 사용자 중 서비스 약관에 동의한 사용자는 없습니다.
TERMS_STATUS_ACCEPTED 한 명 이상의 회사 사용자가 서비스 약관에 동의했습니다.
TERMS_STATUS_STALE 현재 서비스 약관을 수락한 회사 사용자는 없지만 한 명 이상의 사용자가 이전 서비스 약관을 수락했습니다.

Google Workspace 계정

Google Workspace 고객

JSON 표현 
{
  "customerId": string,
  "preProvisioningTokens": [
    string
  ]
}
필드
customerId

string

필수 항목입니다. 고객 ID입니다.
preProvisioningTokens[]

string

출력 전용. 이전에 기기의 소유권을 주장하는 데 사용된 사전 프로비저닝 토큰입니다.

방법

create

 제로터치 등록 고객을 생성합니다.

list

 partnerId 인수로 식별된 리셀러에 등록된 고객을 나열합니다.