Knox またはゼロタッチ登録の会社（顧客）を一意に識別する Company オブジェクトを作成します。このメソッドが正常に返されると、指定したオーナー（primary_emails）または管理者（secondary_emails）が自分のメールアドレスを Google アカウントに関連付けて、ゼロタッチ ポータル（詳細は IT 管理者向けのゼロタッチ登録を参照）または Samsung アカウントから Knox Mobile Enrollment（KME）ポータルにアクセスできます。
メソッド シグネチャ
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
CreateCustomerRequest
| プロパティ名 | 値 | 必須 | 説明 |
|---|---|---|---|
customer_name |
string |
対応 | 会社名。例: XYZ Corp. ゼロタッチ登録ポータルで同社の従業員に表示 |
primary_emails |
object(string) のリスト |
対応 | ゼロタッチ: オーナーのロールのユーザーのメールアドレス。少なくとも 1 つのメールアドレスが必要です。各メールアドレスを Google アカウントに関連付けられている必要があります。オーナーは管理者と同じアクセス権を共有しますが、組織のポータル ユーザーの追加、削除、編集もできます。 Samsung: お客様の特権管理者のメールアドレス。Samsung はリスト内の最初のメールアドレスのみを取得します。メールアドレスを Samsung アカウントに関連付ける必要があります。 |
secondary_emails |
object(string) のリスト |
× | 管理者ロールの顧客のユーザーのメールアドレス。各メールアドレスを Google アカウントに関連付けられている必要があります。注: このプロパティは Samsung でサポートされていません。 |
vendorParams |
map |
ゼロタッチ: なし Samsung: はい |
追加フィールド、ベンダー指定の Key-Value ペア。SamsungResellerService クラスのリクエストでは、次の値を指定する必要があります。"country": 顧客の ISO 3166-1 国コード（例: 「US」）。 "firstName": 顧客の名（最大 60 文字）。 "lastName": 顧客の姓（最大 60 文字）。 "service": サポートされている値のみ。 |
顧客のレスポンスを作成
| プロパティ名 | 値 | 説明 |
|---|---|---|
customer |
object(Company) |
新しく作成された顧客の詳細を含むオブジェクト。 |
vendor_params |
map |
追加フィールド、ベンダー指定の Key-Value ペア（Samsung の場合のみ）。 |
エラーの動作
エラーが発生すると、ライブラリは次のいずれかのエラーコードを含む CommonException をスローします。
CommonException
| エラーコード |
|---|
INTERNAL_SERVER_ERROR |