REST Resource: partners.vendors

資源: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 公司」,顯示在公司員工的零接觸註冊機制入口網站上。

ownerEmails[]

string

必要欄位。只能輸入。擁有者角色中客戶使用者的電子郵件地址。至少須提供一個 owner_email。擁有者俱有與管理員相同的存取權限,但也可以新增、刪除和編輯貴機構的入口網站使用者。

adminEmails[]

string

選填欄位,管理中客戶使用者的電子郵件地址。每個電子郵件地址都必須與一個 Google 帳戶建立關聯。

termsStatus

enum (TermsStatus)

僅供輸出。本公司的所有使用者是否已接受最新的《服務條款》(ToS)。查看《TermsStatus》。

skipWelcomeEmail

boolean

只能輸入。如果設為 true,系統不會將歡迎電子郵件傳送給客戶。如果裝置會取得額外的 DEVICE_PROTECTION 服務擁有權,建議您略過歡迎電子郵件,因為裝置會在裝置申請時收到個別電子郵件。如果您不是零接觸客戶,系統會忽略這個欄位。

languageCode

string

只能輸入。客戶偏好的地區,以 BCP47 語言代碼表示。這個欄位在輸入內容中通過驗證,因此包含不支援語言代碼的要求將遭到拒絕。

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

僅供輸出。與這位客戶相關聯的 Google Workspace 帳戶。僅適用於客戶公司。

方法

list

列出合作夥伴的廠商。