建立 Company
物件以識別 Knox 或零接觸註冊機制的公司 (客戶)。這個方法成功傳回後,指定的擁有者 (primary_emails
) 或管理員 (secondary_emails
) 可將他們的電子郵件地址與 Google 帳戶建立關聯,藉此存取零接觸入口網站 (詳情請參閱適用於 IT 管理員的零接觸註冊機制) 或 Samsung 帳戶,以存取 Knox 行動註冊 (KME) 入口網站。
方法簽章
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
CreateCustomerRequest
資源名稱 | 值 | 必填 | 說明 |
---|---|---|---|
customer_name |
string |
相容 | 公司名稱。例如在公司的零接觸註冊機制入口網站上向 XYZ 公司顯示。 |
primary_emails |
「object(string) 」的清單 |
相容 | 零接觸:擁有者角色中客戶使用者的電子郵件地址。至少必須輸入一個電子郵件地址。每個電子郵件地址都必須與一個 Google 帳戶建立關聯。擁有者俱有與管理員相同的存取權限,但也可以新增、刪除及編輯貴機構的入口網站使用者。 Samsung:客戶超級管理員的電子郵件地址。三星只會收到清單中的第一封電子郵件。電子郵件地址必須與 Samsung 帳戶建立關聯。 |
secondary_emails |
「object(string) 」的清單 |
否 | 管理中客戶使用者的電子郵件地址。每個電子郵件地址都必須與一個 Google 帳戶建立關聯。注意:Samsung 不支援這項屬性。 |
vendorParams |
map |
零接觸:否 Samsung:是 |
其他欄位,廠商指定的鍵/值組合。來自 SamsungResellerService 類別的要求必須指定:"country": 客戶的 ISO 3166-1 國家/地區代碼,例如「US」。 "firstName":客戶的名字 (最多 60 個字元)。 "lastName":客戶的姓氏 (最多 60 個字元)。 "service": "KME" 是唯一支援的值。 |
建立客戶回應
資源名稱 | 值 | 說明 |
---|---|---|
customer |
object( Company ) |
內含新建立的客戶詳細資料的物件。 |
vendor_params |
map |
額外欄位、供應商指定的鍵/值組合 (僅限 Samsung)。 |
錯誤行為
如果發生錯誤,程式庫會擲回包含以下其中一個錯誤代碼的 CommonException
:
CommonException
錯誤代碼 |
---|
INTERNAL_SERVER_ERROR |