建立 Company 物件，用於識別 Knox 或零接觸註冊程序中的公司 (客戶)。方法順利傳回後，指定的擁有者 (primary_emails) 或管理員 (secondary_emails) 可以將自己的電子郵件地址與 Google 帳戶建立關聯，以便存取零接觸入口網站 (詳情請參閱「IT 管理員的零接觸註冊」)，或是使用 Samsung 帳戶存取 Knox 行動註冊機制 (KME) 入口網站。
方法簽章
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
CreateCustomerRequest
| 屬性名稱 | 值 | 必填 | 說明 |
|---|---|---|---|
customer_name |
string |
是 | 公司名稱。例如 XYZ Corp.，在零接觸註冊機制入口網站中向公司員工顯示這項資訊。 |
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 |