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

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

請按照這份快速入門指南中的步驟進行，大約 10 分鐘後簡單的 Java 指令列應用程式，向零接觸。

必要條件

如要執行本快速入門導覽課程，您需要：

擁有零接觸註冊機制經銷商的 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，請按照下列步驟操作：

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

步驟 5：執行範例

利用作業系統的相關說明，執行檔案中的指令碼。UNIX 和 Mac ，在終端機中執行下列指令：

gradle -q run

疑難排解

透過快速入門導覽課程告訴我們您遇到的問題，我們會盡力協助您修復問題。如想瞭解零接觸機制如何使用服務帳戶授權 API 呼叫，請參閱授權：