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

始める

販売パートナーは、共通 Android 販売パートナーライブラリを使用する前に、Samsung の Knox Deployment Program と Android ゼロタッチ登録に参加する必要があります。

Knox Deployment Program（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: ゼロタッチ登録プログラムに参加する

ゼロタッチ登録をオンボーディングします。
共通 Android 販売パートナーライブラリは Reseller API を使用するため、Google Platform ソリューションコンサルタントに 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 ドキュメントのコンソールでプロジェクトを管理するをご覧ください。

新しいサービス認証情報の追加

新しい認証情報とサービスアカウントをプロジェクトに追加するには、API Console で次の手順を行います。

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

サービスアカウントのメールアドレスをコピーして、すぐに使用できるようにしておきます。後でサービスアカウントを組織にリンクするときに必要になります。

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

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

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

鍵ファイルを安全に保存する方法については、API キーを安全に使用するためのおすすめの方法をご覧ください。

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

ライブラリで Reseller API を使用するには、まず API を有効にする必要があります。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 API Console で同じ Google アカウントを使用していることを確認してください。お使いの Google アカウントで API にアクセスできるかどうかについては、Google プラットフォームソリューションコンサルタントにお問い合わせください。

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

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

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

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

Google API Console の [サービスアカウント] ページから取得したサービスアカウント 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 デバイスを登録できるようになりました。

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

始める