createCustomer

创建一个 Company 对象,用于唯一标识公司(客户)以进行 Knox 或零触摸注册。此方法返回成功后,指定的所有者 (primary_emails) 或管理员 (secondary_emails) 可以将其电子邮件地址与 Google 帐号关联以访问零触摸门户(如需了解详情,请参阅面向 IT 管理员的零触摸注册)或访问 Knox 移动注册 (KME) 门户的三星帐号。

方法签名

public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;

CreateCustomerRequest

属性名称 价值 必需 说明
customer_name string 兼容 公司的名称。例如,XYZ Corp. 在零触摸注册门户中向公司的员工显示。
primary_emails object(string)的列表 兼容 零触摸:所有者角色中客户用户的电子邮件地址。必须至少提供一个电子邮件地址。每个电子邮件地址都必须与 Google 帐号相关联。所有者与管理员拥有相同的访问权限,但也可以添加、删除和修改贵组织的门户用户。

三星:客户超级用户的电子邮件地址。三星只会接收列表中的第一封电子邮件。电子邮件地址必须与 Samsung 帐号相关联。
secondary_emails object(string)的列表 拥有管理员角色的客户用户的电子邮件地址。每个电子邮件地址都必须与 Google 帐号相关联。注意:三星不支持此属性。
vendorParams map 零触摸:否

三星:是
额外字段,供应商指定的键值对。来自 SamsungResellerService 类的请求必须指定:

“country”:客户的 ISO 3166-1 国家/地区代码,例如“US”。

“firstName”:客户的名字(最多 60 个字符)。

“lastName”:客户的姓氏(最多 60 个字符)。

“service”:“KME”是唯一受支持的值。

创建客户响应

属性名称 价值 说明
customer object(Company) 此对象包含新创建的客户的详细信息。
vendor_params map 额外字段,供应商指定的键值对(仅限 Samsung)。

错误行为

如果发生错误,该库会抛出 CommonException,其中包含以下错误代码之一:

CommonException

错误代码
INTERNAL_SERVER_ERROR