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 |