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

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

必要條件

如要執行這個快速入門,您需要:

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

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

  1. 請使用這個精靈在 Google Developers Console 中建立或選取專案,並自動啟用 API。依序點選「繼續」和「前往憑證」
  2. 將「您需要存取什麼資料?」設為「應用程式資料」
  3. 按一下「繼續」,系統會提示您建立服務帳戶。
  4. 在「Service account name」(服務帳戶名稱) 中輸入描述性名稱。
  5. 請記下服務帳戶 ID (看起來像電子郵件地址),因為您稍後會用到這個 ID。
  6. 將「角色」設為「服務帳戶」>「服務帳戶使用者」。
  7. 按一下「Done」(完成),即完成建立服務帳戶。
  8. 按一下您建立的服務帳戶電子郵件地址。
  9. 按一下「金鑰」。
  10. 依序按一下「新增金鑰」和「建立新的金鑰」。
  11. 在「金鑰類型」中選取「JSON」。
  12. 按一下「Create」,私密金鑰就會下載到電腦中。
  13. 按一下「關閉」。**
  14. 將檔案移至工作目錄,並將其重新命名為 service_account_key.json
  1. 開啟零接觸註冊機制入口網站。您可能需要登入。
  2. 按一下 「Service accounts」
  3. 按一下 「連結服務帳戶」
  4. 將「電子郵件地址」設為您建立的服務帳戶地址。
  5. 按一下「連結服務帳戶」,即可使用服務帳戶和零接觸註冊帳戶。

步驟 3:準備專案

請按照下列步驟設定 Gradle 專案:

  1. 執行下列指令,在工作目錄中建立新專案:

    gradle init --type basic
    mkdir -p src/main/java src/main/resources
    
  2. 將您在步驟 1 下載的 service_account_key.json 檔案複製到上述建立的 src/main/resources/ 目錄中。

  3. 開啟預設的 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,請按照下列步驟操作:

  1. 開啟入口網站,您可能需要登入。
  2. 按一下 「Service Accounts」
  3. 複製「你的經銷商 ID」行中的合作夥伴 ID 編號。

步驟 5:執行範例

請使用作業系統的說明,執行檔案中的指令碼。在 UNIX 和 Mac 電腦上,請在終端機中執行下列指令:

gradle -q run

疑難排解

告訴我們快速入門課程有哪些錯誤,我們會盡力修正。如想瞭解零接觸機制如何使用服務帳戶授權 API 呼叫,請參閱「授權」。

瞭解詳情