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 |