このクイックスタート ガイドの手順に沿って操作してください。10 分ほどで ゼロタッチにリクエストを送信するシンプルな Java コマンドライン アプリ 登録販売パートナー API。
前提条件
このクイックスタートを実行するには、以下のものが必要です。
- Google アカウント(ゼロタッチ登録販売パートナーのメンバー) あります。まだオンボーディングを開始していない場合は、販売パートナー ポータル ガイドのスタートガイドの手順に沿って操作してください。
- Java 1.7 以降。
- Gradle 2.3 以降。
- インターネット アクセスとウェブブラウザ。
ステップ 1: ゼロタッチ登録 API を有効にする
- こちらの ウィザードを使用して、Google Developers Console でプロジェクトを作成または選択し、 API が自動的に有効になります。[続行] をクリックし、[認証情報に進む] をクリックします。 。
- [アクセスするデータの種類] を [アプリケーション データ] に設定します。
- [次へ] をクリックします。サービス アカウントを作成するように求められ、 あります。
- [サービス アカウント名] にわかりやすい名前を付けます。
- 後で使用するため、サービス アカウント ID(メールアドレスに似ています)をメモしておきます。
- [ロール] を [サービス アカウント] > [サービス アカウント ユーザー] に設定します。
- [完了] をクリックして、サービス アカウントの作成を完了します。
- 作成したサービス アカウントのメールアドレスをクリックします。
- [キー] をクリックします。
- [鍵を追加]、[新しい鍵を作成] の順にクリックします。
- [**鍵のタイプ**] で [**JSON**] を選択します。
- [作成] をクリックすると、秘密鍵がパソコンにダウンロードされます。
- [**閉じる**] をクリックします。
- ファイルを作業ディレクトリに移動し、名前を
service_account_key.json
に変更します。
ステップ 2: サービス アカウントをリンクする
- ゼロタッチ登録ポータルを開きます。ログインが必要となる場合があります。
- [サービス アカウント] をクリックします。
- [サービス アカウントをリンク] をクリックします。
- [メールアドレス] に、作成したサービス アカウントのメールアドレスを設定します。
- [サービス アカウントをリンク] をクリックして、ゼロタッチ登録アカウントでサービス アカウントを使用します。
ステップ 3: プロジェクトを準備する
Gradle プロジェクトを設定する手順は次のとおりです。
次のコマンドを実行して、作業ディレクトリに新しいプロジェクトを作成します。
gradle init --type basic mkdir -p src/main/java src/main/resources
手順 1 でダウンロードした
service_account_key.json
ファイルを 先ほど作成したsrc/main/resources/
ディレクトリ。デフォルトの
build.gradle
ファイルを開き、内容を コード:apply plugin: 'java' apply plugin: 'application' mainClassName = 'ResellerQuickstart' sourceCompatibility = 1.7 targetCompatibility = 1.7 version = '1.0' repositories { mavenCentral() } dependencies { compile 'com.google.api-client:google-api-client:1.30.11' compile 'com.google.apis:google-api-services-androiddeviceprovisioning:+' compile 'com.google.oauth-client:google-oauth-client-jetty:+' }
ステップ 4: サンプルを設定する
src/main/java/ResellerQuickstart.java
という名前のファイルを作成し、次のコードをコピーしてファイルを保存します。独自の販売パートナーを挿入
ID を PARTNER_ID
の値として指定します(アプリの 1 行目)。
import com.google.api.client.auth.oauth2.Credential; import com.google.api.client.googleapis.auth.oauth2.GoogleCredential; import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport; import com.google.api.client.http.HttpTransport; import com.google.api.client.json.JsonFactory; import com.google.api.client.json.jackson2.JacksonFactory; import com.google.api.services.androiddeviceprovisioning.v1.AndroidProvisioningPartner; import com.google.api.services.androiddeviceprovisioning.v1.model.Company; import com.google.api.services.androiddeviceprovisioning.v1.model.ListCustomersResponse; import java.io.IOException; import java.io.InputStream; import java.io.InputStreamReader; import java.util.Arrays; import java.util.List; /** * This class forms the quickstart introduction to the zero-touch enrollemnt * reseller API. */ public class ResellerQuickstart { // TODO: replace this with your partner reseller ID. private static long PARTNER_ID = 11036885; // Use a single scope for the all methods in the reseller API. private static final List<String> SCOPES = Arrays.asList("https://www.googleapis.com/auth/androidworkprovisioning"); private static final String APP_NAME = "Zero-touch Reseller Java Quickstart"; // Global shared instances. private static final JsonFactory JSON_FACTORY = JacksonFactory.getDefaultInstance(); private static HttpTransport HTTP_TRANSPORT; static { try { HTTP_TRANSPORT = GoogleNetHttpTransport.newTrustedTransport(); } catch (Throwable t) { t.printStackTrace(); System.exit(1); } } /** * Creates a Credential object with the correct OAuth2 authorization * for the service account that calls the reseller API. The service * endpoint invokes this method when setting up a new service instance. * @return an authorized Credential object. * @throws IOException */ public static Credential authorize() throws IOException { // Load the service account key from the JSON file. InputStream in = ResellerQuickstart.class.getResourceAsStream("/service_account_key.json"); // Create the credential scoped to the zero-touch enrollemnt // reseller APIs. GoogleCredential credential = GoogleCredential .fromStream(in) .createScoped(SCOPES); return credential; } /** * Builds and returns an authorized zero-touch enrollment API client service. * Use the service endpoint to call the API methods. * @return an authorized client service endpoint * @throws IOException */ public static AndroidProvisioningPartner getService() throws IOException { Credential credential = authorize(); return new AndroidProvisioningPartner.Builder( HTTP_TRANSPORT, JSON_FACTORY, credential) .setApplicationName(APP_NAME) .build(); } /** * Runs the zero-touch enrollment quickstart app. * @throws IOException */ public static void main(String[] args) throws IOException { // Create a zero-touch enrollment API service endpoint. AndroidProvisioningPartner service = getService(); // Send an API request to list all our customers. AndroidProvisioningPartner.Partners.Customers.List request = service.partners().customers().list(PARTNER_ID); ListCustomersResponse response = request.execute(); // Print out the details of each customer. if (response.getCustomers() != null) { java.util.List<Company> customers = response.getCustomers(); for (Company customer : customers) { System.out.format("Name:%s ID:%d\n", customer.getCompanyName(), customer.getCompanyId()); } } else { System.out.println("No customers found"); } } }
パートナー ID
API 呼び出しでは通常、販売パートナー ID を引数として指定する必要があります。お客様の パートナー ID を取得する手順は次のとおりです。
- ポータルを開きます。ログインが必要となる場合があります。
- [ サービス] をクリックします。 。
- [販売パートナー ID] 行からパートナー ID 番号をコピーします。
ステップ 5: サンプルを実行する
オペレーティング システムのヘルプを使用して、ファイル内のスクリプトを実行します。UNIX コンピュータと Mac コンピュータでは、ターミナルで次のコマンドを実行します。
gradle -q run
トラブルシューティング
クイックスタートの問題があればお知らせください。サポートさせていただきます。 修正しますゼロタッチがサービス アカウントを使用して API 呼び出しを承認する方法については、 承認。