建立客戶

建立 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