請按照本快速入門指南內的步驟操作,大約 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 呼叫,請參閱「授權」。