REST Resource: partners.vendors.customers

资源:公司

零触摸转销商 API 和客户 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 语言代码表示。系统会在您输入时验证此字段,并拒绝包含不受支持的语言代码的请求。

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

仅限输出。与此客户关联的 Google Workspace 账号。仅供客户公司使用。

方法

list

列出供应商的客户。