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

必須。入力のみ。オーナーのロールのユーザーのメールアドレス。少なくとも 1 つの owner_email が必要です。オーナーは管理者と同じアクセス権を共有しますが、組織のポータル ユーザーの追加、削除、編集も行うことができます。
adminEmails[]

string

（省略可）管理者ロールの顧客のユーザーのメールアドレス。各メールアドレスを Google アカウントに関連付けられている必要があります。
termsStatus

enum (TermsStatus)

出力のみ。会社のユーザーが最新の利用規約（ToS）に同意したかどうか。TermsStatusをご確認ください。
skipWelcomeEmail

boolean

入力のみ。true に設定した場合、ウェルカム メールは顧客に送信されません。追加の DEVICE_PROTECTION サービスでデバイスの申請が発生する場合は、デバイスの申請時に個別にメールが届くため、ウェルカム メールはスキップすることをおすすめします。ゼロタッチ登録の顧客でない場合、このフィールドは無視されます。
languageCode

string

入力のみ。顧客の希望する言語 / 地域。BCP47 言語コードで表されます。このフィールドは入力時に検証され、サポートされていない言語コードを含むリクエストは拒否されます。サポートされる言語コード: アラビア語（ar）中国語（繁体）の英語版
googleWorkspaceAccount

object (GoogleWorkspaceAccount)

出力のみ。このお客様に関連付けられている Google Workspace アカウントです。お客様の会社でのみ使用されます。

規約のステータス

企業がゼロタッチ登録の利用規約（ToS）に同意する。1 人のユーザーがウェブポータルを使用して、会社の利用規約に同意できます。

利用規約はバージョン管理されています。利用規約が変更されたときに、少なくとも 1 人のユーザーが新しい利用規約に同意する必要があります。最初のユーザーが新しい利用規約に同意するまで、会社の利用規約のステータスは TERMS_STATUS_STALE になります。

列挙型
TERMS_STATUS_NOT_ACCEPTED 会社のどのユーザーも利用規約に同意していません。
TERMS_STATUS_ACCEPTED 会社のユーザーの 1 人以上が利用規約に同意しました。
TERMS_STATUS_STALE 現在の利用規約を承諾したユーザーは 1 人もいませんでしたが、以前の利用規約には 1 人以上ユーザーが同意しています。

Google Workspace アカウント

Google Workspace のお客様。

JSON 表現 
{
  "customerId": string,
  "preProvisioningTokens": [
    string
  ]
}
フィールド
customerId

string

必須。お客様 ID。
preProvisioningTokens[]

string

出力のみ。以前はデバイスの要求に使用された事前プロビジョニング トークンです。

Methods

create

 ゼロタッチ登録用の顧客を作成します。

list

 partnerId 引数で識別される販売パートナーに登録されている顧客を一覧表示します。