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

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

只要按照本快速入門指南中的步驟操作，大約 10 分鐘內，您就能擁有一個簡單的 Java 指令列應用程式，用於向零接觸註冊經銷商 API 提出要求。

必要條件

如要執行這個快速入門，您需要：

擁有零接觸註冊機制經銷商的 Google 帳戶讓他們使用服務帳戶如果您尚未加入，請按照請參閱經銷商入口網站指南。
Java 1.7 以上版本。
Gradle 2.3 以上版本。
連上網際網路和網路瀏覽器。

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

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

步驟 2：連結服務帳戶

開啟零接觸註冊機制入口網站。您可能需要登入。
按一下「Service accounts」。
按一下「連結服務帳戶」。
將「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 呼叫，請參閱授權：