本頁面由 Cloud Translation API 翻譯而成。

經銷商適用的 Java 快速入門導覽課程

請按照本快速入門指南中的步驟進行，在大約 10 分鐘內就能取得一個簡單的 Java 命令列應用程式，可向零接觸註冊機制經銷商 API 發出要求。

必要條件

如要執行本快速入門導覽課程，您必須符合以下條件：

這個 Google 帳戶是您的零接觸註冊機制經銷商帳戶的成員。如果您尚未加入，請按照經銷商入口網站指南的開始使用步驟進行。
Java 1.7 以上版本。
Gradle 2.3 以上版本。
網際網路和網路瀏覽器的存取。

步驟 1：啟用零接觸註冊機制 API

請使用這個精靈在 Google Developers Console 中建立或選取專案，並自動啟用 API。按一下 [繼續]，然後點選 [前往憑證]。
將 [您將存取哪些資料？] 設為 [應用程式資料]。
點選「下一步」。系統會提示您建立服務帳戶。
為服務帳戶名稱輸入描述性名稱。
請記下服務帳戶 ID (看起來像電子郵件地址)，因為您稍後會使用它。
將「角色」設為 [服務帳戶] > [服務帳戶使用者]。
按一下「Done」(完成)，即完成建立服務帳戶。
按一下您建立的服務帳戶的電子郵件地址。
按一下 [金鑰]。
依序點選 [新增金鑰] 和 [建立新的金鑰]。
在 [金鑰類型] 選取 [JSON]。
按一下 [建立]，然後將私密金鑰下載到您的電腦中。
按一下 [關閉]。
將檔案移至您的工作目錄，並重新命名為 service_account_key.json。

步驟 2：連結服務帳戶

開啟零接觸註冊機制入口網站。您可能需要登入。
按一下 [ 服務帳戶]。
按一下「連結服務帳戶」。
將「Email address」(電子郵件地址) 設為您建立的服務帳戶地址。
按一下 [連結服務帳戶]，即可將服務帳戶用於零接觸註冊帳戶。

步驟 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 (應用程式的第一行) 的值。

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，請按照下列步驟操作：

開啟入口網站，您可能需要登入。
按一下 [Service accounts] (服務帳戶)
從「您的經銷商 ID」行複製您的合作夥伴 ID。

步驟 5：執行範例

請根據作業系統的說明，在檔案中執行指令碼。在 UNIX 和 Mac 電腦上，在終端機執行下列指令：

gradle -q run

疑難排解

請透過快速入門導覽課程告訴我們哪裡出錯，我們會盡力解決。如要瞭解零接觸功能如何使用服務帳戶授權 API 呼叫，請參閱授權。