このページは Cloud Translation API によって翻訳されました。

使ってみる

販売パートナーは、Common Android Reseller Library を使用する前に、Samsung の Knox デプロイプログラム Android ゼロタッチ登録です

Knox デプロイプログラム（KDP）

以下の手順に沿って KDP に参加にアクセスして、販売パートナーライブラリの使用を開始するために必要な詳細情報を取得します。

ステップ 1: KDP に登録する

販売パートナー向け Samsung Knox をご覧ください。 KDP に登録してください。
Samsung アカウントを作成し、Samsung Knox アカウントを販売パートナーとして登録します。
販売パートナーアカウントが承認されたら、KDP ポータルにログインして resellerId を見つけます。

ステップ 2: Knox Cloud API ポータルへのアクセス権をリクエストする

Knox Cloud API ポータルへのアクセス権を取得するには、Samsung にリクエストを送信します。
Knox Cloud API ポータルにログインします。

ステップ 3: サービスアカウントキーと `clientIdentifier` を取得する

Knox Cloud API ポータルから鍵ペアの JSON ファイルをダウンロードして保存する安全な場所に保管します。
Knox Cloud API ポータルで一意の clientIdentifier を生成します。

ステップ 4: `SamsungResellerService` オブジェクトを作成する

JSON ファイルパス clientIdentifier、resellerId を使用して、共通ライブラリを使用する SamsungResellerService オブジェクトを作成します。

ゼロタッチ登録

ステップ 1: ゼロタッチ登録プログラムに参加する

ゼロタッチ登録でオンボーディングする。
Common Android Reseller Library は Reseller API を使用するため、 Google プラットフォームから Reseller API へのアクセスをリクエストする必要があります。ソリューションコンサルタント
ゼロタッチポータルへのアクセス権をリクエストします。

ポータルへのアクセスに使用するのと同じ Google アカウントで、残りの手順に沿ってサービスアカウントを作成し、Reseller API を有効にします。

ステップ 2: サービスアカウントを作成する

サービスアカウント（ロボットアカウントとも呼ばれます）は、Google アカウントとユーザーではなくアプリを表します登録ライブラリはサービスアカウントの代わりに Google API を使用する場合は、Google API Console を使用してできます。

API Console プロジェクトを作成する

新しい API Console プロジェクトとサービスを作成することをおすすめします。あります。これにより、アクセスの管理、リソースの管理、紛失した鍵の復旧が可能になります。簡単に利用できるようになるでしょうまず、以下の手順に沿って新しいプロジェクトを作成します。 Google API Console の場合:

API Console に移動します。
プロジェクトリストから プロジェクトを作成します。
アプリとゼロタッチ登録を説明する名前を入力します。
プロジェクト ID を指定するか、デフォルトのままにします。
[作成] をクリックします。

詳細については、Google Cloud Platform のドキュメント「コンソールでプロジェクトを管理する」をご覧ください。

新しいサービス認証情報を追加する

新しい認証情報とサービスアカウントをプロジェクトに追加する手順は次のとおりです。下に表示されます。

[サービスアカウント] ページを開きます。画面のメッセージに従って、プロジェクトを選択します。
[ サービスアカウントを作成] をクリックして、サービスアカウントの名前と説明を入力します。デフォルトのサービスアカウント ID を使用することも、別の一意の ID を選択することもできます。入力したら、[作成] をクリックします。
以降の [サービスアカウントの権限（オプション）] セクションは必須ではありません。[続行] をクリックします。
[ユーザーにこのサービスアカウントへのアクセスを許可] 画面で、[キーの作成] セクションまで下にスクロールします。[ キーを作成] をクリックします。
表示されたサイドパネルで、キーの形式を選択します。JSON をおすすめします。
[作成] をクリックします。新しい公開鍵と秘密鍵のペアが生成され、パソコンにダウンロードされます。この鍵は再発行できませんので、安全に保管する方法については、サービスアカウントキーの管理をご覧ください。
[秘密鍵がパソコンに保存されました] ダイアログで [閉じる] をクリックし、[完了] をクリックしてサービスアカウントの表に戻ります。

サービスアカウントのメールアドレスをコピーして、手近なところに保存しておいてください。必要な機能後でサービスアカウントを組織にリンクする際に設定を行います。

ステップ 3: JSON キーファイルを保存する

API Console で、認証に使用される新しい秘密鍵ペアが生成されるサービスアカウントを使用して行われた API 呼び出し。秘密鍵はダウンロードした JSON キーファイルの中にあります。

この鍵は非公開にしておく必要があります。ソフトウェアのソースに含めないでください。説明します。キーファイルを紛失した場合は、新たな鍵ペアを生成する必要があります。

鍵ファイルの安全な保存について詳しくは、 API キーを使用して安全に保護するをご覧ください。

ステップ 4: API を有効にする

ライブラリから Reseller API を使用できるようにするには、それを有効にする必要があります。API を有効にすると、現在の API Console プロジェクトに関連付けられますコンソールにモニタリングページを追加します。

Reseller API を有効にするには、API Console で次の手順を行います。

[API とサービス >ライブラリ。
検索フィールドを使用して [Android Device Provisioning Partner API] を探します。
[Android Device Provisioning Partner API] をクリックします。
[有効にする] をクリックします。

しばらくすると、API のステータスが有効に変化します。Android Device Provisioning Partner API が表示されない場合は、ご自身の組織がゼロタッチ登録にオンボーディングされていることを確認してください。使用する Google Cloud プロダクトと同じゼロタッチ登録と Google API Console について説明します。Google に質問するプラットフォームソリューションコンサルタントが、お使いの Google アカウントに以下へのアクセス権があるかどうかを確認します。できます。

ステップ 5: サービスアカウントをリンクする

サービスアカウントと組織のゼロタッチ登録をリンクするそのサービスアカウントがユーザーの代わりに API を呼び出すことをできます。サービスアカウントをリンクする手順は次のとおりです。

ゼロタッチ登録ポータルを開きます。ログインが必要となる場合があります。
[ サービス] をクリックします。。
[サービスアカウントをリンク] をクリックします。
[メールアドレス] に、作成したサービスアカウントのメールアドレスを設定します。
[サービスアカウントをリンク] をクリックして、ゼロタッチ登録アカウントでサービスアカウントを使用します。

作成したサービスアカウントのメールアドレスが見つからない場合は、コピーします。次のいずれかの場所から確認できます

[サービスアカウント] ページのサービスアカウント ID できます。
JSON キーファイルの client_email プロパティフィールド。

これで、登録ライブラリでサービスアカウントを使用して、 ResellerService オブジェクト。

共通 Android 販売パートナーライブラリを Gradle プロジェクトに追加する

このライブラリは Maven リポジトリとして入手できます。新しい Gradle プロジェクトにライブラリを追加する手順は次のとおりです。

次のコマンドを実行して、新しいプロジェクトを作成します。
```
gradle init --type basic
mkdir -p src/main/java src/main/resources
```
ステップ 2 でダウンロードした service_account_key.json ファイルをコピーします。先ほど作成した src/main/resources/ ディレクトリに移動します。
デフォルトの build.gradle ファイルを開き、中央の Maven リポジトリを宣言する追加します。
```
repositories {
    mavenCentral()
}
```

同じファイルに次の依存関係を追加します。

dependencies {
    implementation 'com.github.kmeztapi:reseller-api:+'
}

これで、プロジェクトでクライアントライブラリを使用して Android を登録できるようになりましたできます。

次のステップ: 一般的なオペレーション