创建 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:客户的超级用户的电子邮件地址。Samsung 只会使用列表中的第一个电子邮件地址。电子邮件地址必须与三星账号相关联。 |
secondary_emails |
object(string) 的列表 |
否 | 客户具有管理员角色的用户的电子邮件地址。每个电子邮件地址都必须与 Google 账号相关联。注意:三星不支持此属性。 |
vendorParams |
map |
零触摸:否 三星:是 |
额外字段,供应商指定的键值对。来自 SamsungResellerService 类的请求必须指定:“国家/地区”:客户的 ISO 3166-1 国家/地区代码,例如“US”。 “firstName”:客户的名字(最多 60 个字符)。 “lastName”:客户的姓氏(最多 60 个字符)。 "service": "KME"是唯一支持的值。 |
CreateCustomerResponse
属性名称 | 值 | 说明 |
---|---|---|
customer |
object( Company ) |
包含新创建的客户详细信息的对象。 |
vendor_params |
map |
额外字段,供应商指定的键值对(仅限三星)。 |
错误行为
如果发生错误,该库会抛出 CommonException
,其中包含其中一个
错误代码:
CommonException
错误代码 |
---|
INTERNAL_SERVER_ERROR |