按照本快速入门指南中的步骤操作,大约 10 分钟后,您将拥有一个简单的 Java 命令行应用,该应用可向零触摸注册转销商 API 发出请求。
前提条件
如需运行本快速入门,您需要满足以下条件:
- 一个 Google 账号(属于您的零触摸注册转销商的成员) 。如果您尚未完成初始配置,请按照使用入门中的步骤操作 转销商门户指南。
- Java 1.7 或更高版本。
- Gradle 2.3 或更高版本。
- 能够访问互联网和网络浏览器。
第 1 步:启用零触摸注册 API
- 使用此 向导,以在 Google Developers Console 中创建或选择项目。 系统会自动启用该 API。点击继续,然后点击转到凭据。
- 将您要访问哪些数据?设置为应用数据。
- 点击下一步。系统应该会提示您创建 Service 。
- 为服务账号名称提供一个描述性名称。
- 记下服务账号 ID(看起来像电子邮件地址),因为您稍后将用到它。
- 将角色设置为服务账号 > Service Account User。
- 点击完成以完成服务账号的创建过程。
- 点击您创建的服务账号的电子邮件地址。
- 点击 **Keys**。
- 点击**添加密钥**,然后点击**创建新密钥**。
- 对于 **密钥类型**,选择 **JSON**。
- 点击创建,私钥便会下载到您的计算机。
- 点击 **Close**。
- 将该文件移至您的工作目录中,并将其重命名为
service_account_key.json
。
第 2 步:关联服务账号
- 打开零触摸注册门户。您可能需要登录。
- 点击 服务 账号。
- 点击 关联服务账号。
- 将电子邮件地址设置为您创建的服务账号的地址。
- 点击关联服务账号,将服务账号与零触摸注册账号搭配使用。
第 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 调用,请参阅授权。