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。擁有者的權限與管理員相同，但還可以新增、刪除及編輯貴機構的入口網站使用者。
adminEmails[]

string

選用設定。具備管理員角色的客戶使用者電子郵件地址。每個電子郵件地址都必須與 Google 帳戶建立關聯。
termsStatus

enum (TermsStatus)

僅供輸出。公司是否有使用者接受最新的《服務條款》(ToS)。詳情請參閱《TermsStatus》。
skipWelcomeEmail

boolean

僅限輸入。如果設為 true，系統就不會將歡迎電子郵件傳送給客戶。如果裝置會使用額外的 DEVICE_PROTECTION 服務聲明擁有權，建議您略過這封歡迎電子郵件，因為客戶會在申請裝置時收到個別的電子郵件。如果不是零接觸客戶，系統就會忽略這個欄位。
languageCode

string

僅限輸入。客戶的偏好地區，以 BCP47 語言代碼表示。系統已根據輸入內容驗證這個欄位，如果要求包含不支援的語言代碼，將遭到拒絕。支援的語言代碼：阿拉伯文 (ar) 中文 (香港) 中文 (香港) 中文 (香港) (zh-香港) 中文 (繁體) 中文 (繁體) 繁體 (zh-TW) 捷克文 (da) 丹麥文 (荷蘭)、荷蘭文 (荷蘭)、荷蘭文 (荷蘭)、英文 (荷蘭)、英文 (英國) 英文 (英國) 英文 (英國) 英文 (美國) 英文 (美國)) 芬蘭文
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 引數識別，註冊到經銷商的客戶。