资源:公司
零触摸转销商和客户 API 中的转销商、供应商或客户。
JSON 表示法 |
---|
{ "name": string, "companyId": string, "companyName": string, "ownerEmails": [ string ], "adminEmails": [ string ], "termsStatus": enum ( |
字段 | |
---|---|
name |
仅供输出。公司的 API 资源名称。资源名称是以下格式之一:
由服务器分配。 |
companyId |
仅供输出。公司的 ID。由服务器分配。 |
companyName |
必需。公司的名称。例如:XYZ Corp。在零触摸注册门户中向公司的员工显示。 |
ownerEmails[] |
必需。仅限输入。拥有所有者角色的客户用户的电子邮件地址。必须至少提供一个 |
adminEmails[] |
(可选)拥有管理员角色的客户用户的电子邮件地址。每个电子邮件地址都必须与 Google 帐号相关联。 |
termsStatus |
仅供输出。公司的任何用户是否接受了最新的服务条款 (ToS)。请参阅 |
skipWelcomeEmail |
仅限输入。如果设置为 true,则系统不会将欢迎电子邮件发送给客户。如果通过附加 DEVICE_PROTECTION 服务领取设备,建议跳过欢迎电子邮件,因为客户会在设备领取时收到不同的电子邮件。如果不是零触摸客户,则忽略此字段。 |
languageCode |
仅限输入。以 BCP47 语言代码表示的客户的首选语言区域。系统会在输入时验证此字段,如果请求中包含不受支持的语言代码,则会被拒绝。。 |
googleWorkspaceAccount |
仅供输出。与此客户关联的 Google Workspace 帐号。仅用于客户公司。 |
条款状态
公司接受零触摸注册服务条款 (ToS)。单个用户可以使用网站门户接受其公司的服务条款。
服务条款具有版本编号。也就是说,如果《服务条款》(ToS) 发生变更,必须至少有一名用户接受新的服务条款。在首位用户接受新版《服务条款》之前,公司的条款状态为 TERMS_STATUS_STALE
。
枚举 | |
---|---|
TERMS_STATUS_NOT_ACCEPTED |
公司的任何用户都没有接受服务条款。 |
TERMS_STATUS_ACCEPTED |
公司的一位或多位用户已接受服务条款。 |
TERMS_STATUS_STALE |
公司的用户均未接受当前服务条款,但至少有一个用户接受了之前的服务条款。 |
Google Workspace 帐号
Google Workspace 客户。
JSON 表示法 |
---|
{ "customerId": string, "preProvisioningTokens": [ string ] } |
字段 | |
---|---|
customerId |
必需。客户 ID。 |
preProvisioningTokens[] |
仅供输出。之前用于认领设备的预配置令牌。 |
方法 |
|
---|---|
|
创建零触摸注册的客户。 |
|
列出已注册到转销商(通过 partnerId 参数标识)的客户。 |