REST Resource: partners.customers

리소스: 회사

제로터치 리셀러 및 고객 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이 한 개 이상 필요합니다. 소유자는 관리자와 동일한 액세스 권한을 공유하지만 조직의 포털 사용자를 추가, 삭제, 수정할 수도 있습니다.

adminEmails[]

string

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

termsStatus

enum (TermsStatus)

출력 전용입니다. 회사의 사용자가 최신 서비스 약관에 동의했는지 여부 TermsStatus를 참조하세요.

skipWelcomeEmail

boolean

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

languageCode

string

입력 전용입니다. BCP47 언어 코드로 표시되는 고객의 기본 언어입니다. 이 필드는 입력 시 검증되며 지원되지 않는 언어 코드가 포함된 요청은 거부됩니다. 지원 언어 코드:

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

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

TermsStatus

회사가 제로터치 등록 서비스 약관 (ToS)에 동의함 단일 사용자가 웹 포털을 통해 회사의 서비스 약관에 동의할 수 있습니다.

서비스 약관에서는 버전이 관리됩니다. 서비스 약관이 변경되면 한 명 이상의 사용자가 새 서비스 약관에 동의해야 합니다. 첫 번째 사용자가 새 서비스 약관에 동의할 때까지 회사의 조건은 TERMS_STATUS_STALE입니다.

열거형
TERMS_STATUS_NOT_ACCEPTED 회사 사용자 중 서비스 약관에 동의한 사용자가 없습니다.
TERMS_STATUS_ACCEPTED 회사 사용자 중 한 명 이상이 서비스 약관에 동의했습니다.
TERMS_STATUS_STALE 회사의 사용자 중 현재 서비스 약관에 동의한 사용자가 없으며 한 명 이상의 사용자가 이전 서비스 약관에 동의한 경우

GoogleWorkspaceAccount

Google Workspace 고객

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

string

필수 항목입니다. 고객 ID입니다.

preProvisioningTokens[]

string

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

메서드

create

제로터치 등록을 위한 고객을 만듭니다.

list

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