createCustomer
创建 Company 对象，以唯一标识 Knox 或零触摸注册的公司（客户）。该方法成功返回后，指定的所有者 (primary_emails) 或管理员 (secondary_emails) 可以将其电子邮件地址与 Google 账号相关联，以访问零接触客户门户（如需了解详情，请参阅面向 IT 管理员的零接触注册），或与三星账号相关联，以访问 Knox Mobile Enrollment (KME) 门户。
方法签名
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
CreateCustomerRequest
| 属性名称 |
值 |
必填 |
说明 |
customer_name |
string |
是 |
公司的名称。例如 XYZ 公司。在零触摸注册门户中向该公司的员工显示。 |
primary_emails |
object(string) 的列表 |
是 |
零触摸：客户拥有 Owner 角色的用户的电子邮件地址。必须至少输入一个电子邮件地址。每个电子邮件地址都必须与 Google 账号相关联。所有者与管理员拥有相同的访问权限，但还可以添加、删除和修改贵组织的门户用户。
Samsung：客户的超级用户的电子邮件地址。Samsung 只会使用列表中的第一个电子邮件地址。电子邮件地址必须与 Samsung 账号相关联。 |
secondary_emails |
object(string) 的列表 |
否 |
具有管理员角色的客户用户的电子邮件地址。每个电子邮件地址都必须与 Google 账号相关联。注意：三星不支持此属性。 |
vendorParams |
map |
零触摸：否
三星：是 |
额外字段，供应商指定的键值对。SamsungResellerService 类中的请求必须指定：
“country”：客户的 ISO 3166-1 国家/地区代码，例如“US”。
“firstName”：客户的名字（最多 60 个字符）。
“lastName”：客户的姓氏（最多 60 个字符）。
“service”：仅支持值“KME”。 |
CreateCustomerResponse
| 属性名称 |
值 |
说明 |
customer |
object(Company) |
包含新创建的客户的详细信息的对象。 |
vendor_params |
map |
额外字段，供应商指定的键值对（仅限三星）。 |
错误行为
如果发生错误，该库会抛出包含以下错误代码之一的 CommonException：
CommonException
| 错误代码 |
INTERNAL_SERVER_ERROR |
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2024-12-03。
[null,null,["最后更新时间 (UTC)：2024-12-03。"],[[["This process creates a `Company` object to uniquely identify a customer for Knox or zero-touch enrollment."],["The `customer_name`, `primary_emails`, and `vendorParams` are required parameters for creating a customer, and `secondary_emails` is optional."],["`primary_emails` are email addresses for owners (for zero-touch) or super admins (for Samsung), who can access the zero-touch or Knox Mobile Enrollment portal, and must be associated with a Google Account or Samsung Account, respectively."],["`secondary_emails` represent admin users for zero-touch enrollment, must be associated with a Google Account, and are not supported by Samsung."],["The method throws a `CommonException` with an `INTERNAL_SERVER_ERROR` if an issue occurs during customer creation."]]],["This document outlines how to create a `Company` object to identify a customer for Knox or zero-touch enrollment. The `createCustomer` method requires a company name and a list of primary email addresses (owners/super admins). Secondary email addresses (admins) are optional for zero-touch. Samsung requests also need `vendorParams`, specifying country, first name, last name, and \"KME\" service. Successful creation returns a `Company` object, allowing associated emails access to the zero-touch or KME portal. Errors result in a `CommonException`.\n"]]
