Java quickstart for resellers

    • This guide walks you through setting up a simple Java command-line application that interacts with the zero-touch enrollment reseller API in approximately 10 minutes.

    • To begin, you'll need a Google account within your zero-touch enrollment reseller account, Java 1.7 or later, Gradle 2.3 or later, and internet access.

    • The process involves turning on the zero-touch enrollment API, creating and linking a service account within the portal, and downloading a JSON key for authentication.

    • You'll then prepare a Gradle project, copy the service account key, set up the sample Java code with your reseller partner ID, and finally run the application using a simple command.

    • The code when run will list all customers associated with your reseller partner id.

    Follow the steps in this quickstart guide, and in about 10 minutes you'll have a simple Java command-line app that makes requests to the zero-touch enrollment reseller API.

    Prerequisites

    To run this quickstart, you'll need:

    • A Google account, that's a member of your zero-touch enrollment reseller account. If you haven't onboarded yet, follow the steps in Get started in the Reseller portal guide .
    • Java 1.7 or greater.
    • Gradle 2.3 or greater .
    • Access to the internet and a web browser.

    Step 1: Turn on the zero-touch enrollment API

    1. Use this wizard to create or select a project in the Google Developers Console and automatically turn on the API. Click Continue, then Go to credentials.
    2. Set What data will you be accessing?to Application data .
    3. Click Next. You should be prompted to create a service account.
    4. Give a descriptive name for Service account name.
    5. Note the Service account ID(it looks like an email address) because you'll use it later.
    6. Set Roleto Service Accounts > Service Account User .
    7. Click Doneto finish creating the service account.
    8. Click the email address for the service account that you created.
    9. Click **Keys**.
    10. Click **Add key**, then click **Create new key**.
    11. For **Key type**, select **JSON**.
    12. Click Createand the private key downloads to your computer.
    13. Click **Close**.
    14. Move the file to your working directory and rename it service_account_key.json .
    1. Open the zero-touch enrollment portal . You might need to sign in.
    2. Click Service accounts.
    3. Click Link service account.
    4. Set Email addressto the address of the service account you created.
    5. Click Link service accountto use the service account with your zero-touch enrollment account.

    Step 3: Prepare the project

    Follow the steps below to set up your Gradle project:

    1. Run the following command to create a new project in the working directory:

        gradle 
  
 init 
  
 -- 
 type 
  
 basic 
 mkdir 
  
 - 
 p 
  
 src 
 / 
 main 
 / 
 java 
  
 src 
 / 
 main 
 / 
 resources

    2. Copy the service_account_key.json file you downloaded in Step 1 into the src/main/resources/ directory you created above.

    3. Open the default build.gradle file and replace its contents with the following code:

        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 
 : 
 + 
 ' 
 }

    Step 4: Set up the sample

    Create a file named src/main/java/ResellerQuickstart.java and copy in the following code and save the file. Insert your own reseller partner ID as the value for PARTNER_ID (the app's first line).

     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" 
 ); 
  
 } 
  
 } 
 }

    Partner ID

    API calls typically need your reseller partner ID as an argument. To find your partner ID from the zero-touch enrollment portal, follow the steps below:

    1. Open the portal . You might need to sign in.
    2. Click Service accounts.
    3. Copy your partner ID number from the Your reseller IDline.

    Step 5: Run the sample

    Use your operating system's help to run the script in the file. On UNIX and Mac computers, run the command below in your terminal:

     gradle  
-q  
run

    Troubleshooting

    Tell us what went wrong with the quickstart and we'll work to fix it. To learn how zero-touch uses service accounts to authorize API calls, read Authorization .

    Learn more
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: