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 社は、ゼロタッチ登録ポータルで会社の従業員に表示されます。 |
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": サポートされている値は「KME」のみです。 |
CreateCustomerResponse
| プロパティ名 | 値 | 説明 |
|---|---|---|
customer |
object(Company) |
新しく作成された顧客の詳細を含むオブジェクト。 |
vendor_params |
map |
追加フィールド、ベンダー指定の Key-Value ペア（Samsung のみ）。 |
エラーの動作
エラーが発生すると、ライブラリは次のいずれかのエラーコードを含む CommonException をスローします。
CommonException
| エラーコード |
|---|
INTERNAL_SERVER_ERROR |