建立客戶
建立 Company
物件,用於識別 Knox 或零接觸註冊程序中的公司 (客戶)。方法成功傳回後,指定的擁有者 (primary_emails
) 或管理員 (secondary_emails
) 可以將自己的電子郵件地址與 Google 帳戶建立關聯,以便存取零接觸客戶入口網站 (詳情請參閱「IT 管理員的零接觸註冊程序」),或使用 Samsung 帳戶存取 Knox Mobile Enrollment (KME) 入口網站。
方法簽章
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
CreateCustomerRequest
屬性名稱 |
值 |
必填 |
說明 |
customer_name |
string |
是 |
公司名稱。例如 XYZ 公司,會在零接觸註冊入口網站向該公司的員工顯示。 |
primary_emails |
object(string) 的清單 |
是 |
零接觸:客戶擁有者角色使用者的電子郵件地址。至少須提供一個電子郵件地址。每個電子郵件地址都必須與 Google 帳戶建立關聯。擁有者的存取權與管理員相同,但也可以新增、刪除及編輯貴機構的入口網站使用者。
Samsung:客戶的超級管理員電子郵件地址。Samsung 只會使用清單中的第一個電子郵件地址。電子郵件地址必須與 Samsung 帳戶相關聯。 |
secondary_emails |
object(string) 的清單 |
否 |
客戶管理員角色使用者的電子郵件地址。每個電子郵件地址都必須與 Google 帳戶建立關聯。注意:Samsung 不支援這項屬性。 |
vendorParams |
map |
零接觸:否
Samsung:是 |
額外欄位,供應商指定的鍵/值組合。SamsungResellerService 類別的請求必須指定以下項目:
「country」:客戶的 ISO 3166-1 國家/地區代碼,例如「US」。
「firstName」:客戶的名字 (最多 60 個字元)。
「lastName」:客戶的姓氏 (最多 60 個字元)。
「service」:僅支援「KME」這個值。 |
CreateCustomerResponse
屬性名稱 |
值 |
說明 |
customer |
object( Company ) |
包含新建立客戶詳細資料的物件。 |
vendor_params |
map |
額外欄位,供應商指定的鍵/值組合 (僅限 Samsung)。 |
錯誤行為
如果發生錯誤,程式庫會擲回 CommonException
,其中包含下列其中一個錯誤代碼:
CommonException
錯誤代碼 |
INTERNAL_SERVER_ERROR |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-12-03 (世界標準時間)。
[null,null,["上次更新時間: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"]]