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

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

請按照本快速入門指南內的步驟操作，大約 10 分鐘後，您會擁有簡易的 Java 指令列應用程式，可向零接觸註冊經銷商 API 提出要求。

必要條件

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

您的零接觸註冊機制經銷商帳戶的成員 Google 帳戶。如果尚未完成新手上路流程，請按照經銷商入口網站指南中的入門步驟操作。
Java 1.7 以上版本。
Gradle 2.3 以上版本。
可連上網際網路並具備網路瀏覽器。

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

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

步驟 2：連結服務帳戶

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

步驟 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 呼叫，請參閱「授權」。