Seguite i passaggi di questa guida rapida e in circa 10 minuti avrete una semplice app a riga di comando Java che invia richieste alla tecnologia l'API del rivenditore per la registrazione.
Prerequisiti
Per eseguire questa guida rapida, ti serviranno:
- Un Account Google, che sia un membro del tuo rivenditore per la registrazione zero-touch . Se non hai ancora effettuato l'onboarding, segui i passaggi descritti in Inizia in la guida del Portale rivenditori.
- Java 1.7 o versioni successive.
- Gradle 2.3 o versione successiva.
- Accesso a internet e a un browser web.
Passaggio 1: attiva l'API per la registrazione zero-touch
- Utilizza questa procedura guidata per creare o selezionare un progetto in Google Developers Console e attivare automaticamente l'API. Fai clic su Continua, quindi su Vai alle credenziali.
- Imposta A quali dati hai accesso? su Dati applicazione.
- Fai clic su Avanti. Viene richiesto di creare un servizio .
- Assegna un nome descrittivo a Nome account di servizio.
- Prendi nota dell'ID account di servizio (assomiglia a un indirizzo email) perché in un secondo momento.
- Imposta Ruolo su Account di servizio > Utente account di servizio.
- Fai clic su Fine per completare la creazione dell'account di servizio.
- Fai clic sull'indirizzo email dell'account di servizio che hai creato.
- Fai clic su **Chiavi**.
- Fai clic su **Aggiungi chiave** e poi su **Crea nuova chiave**.
- Per **Tipo di chiave**, seleziona **JSON**.
- Fai clic su Crea per scaricare la chiave privata sul tuo computer.
- Fai clic su **Chiudi**.
- Sposta il file nella directory di lavoro e rinominalo
service_account_key.json
.
Passaggio 2: collega l'account di servizio
- Apri il portale per la registrazione zero-touch. Potresti dover eseguire l'accesso.
- Fai clic su Servizio Google Cloud.
- Fai clic su Collega account di servizio.
- Imposta Indirizzo email sull'indirizzo dell'account di servizio che hai creato.
- Fai clic su Collega account di servizio per usare l'account di servizio con la registrazione zero-touch. dell'account di registrazione.
Passaggio 3: prepara il progetto
Segui questi passaggi per configurare il tuo progetto Gradle:
Esegui il comando seguente per creare un nuovo progetto nella directory di lavoro:
gradle init --type basic mkdir -p src/main/java src/main/resources
Copia il file
service_account_key.json
che hai scaricato durante il passaggio 1 nella Directorysrc/main/resources/
creata in precedenza.Apri il file
build.gradle
predefinito e sostituiscine il contenuto con il codice seguente: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:+' }
Passaggio 4: configura il sample
Crea un file denominato src/main/java/ResellerQuickstart.java
e copialo nel
seguire il codice e salvare il file. Inserisci il tuo ID partner rivenditori come valore per PARTNER_ID
(la prima riga dell'app).
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 partner
In genere, per le chiamate API è necessario l'ID rivenditore partner come argomento. Per trovare ID partner dal portale della registrazione zero-touch, segui questi passaggi:
- Apri il portale. Potresti dover eseguire l'accesso.
- Fai clic su Servizio Google Cloud.
- Copia il tuo ID partner dalla riga Il tuo ID rivenditore.
Passaggio 5: esegui l'esempio
Utilizza la guida del sistema operativo per eseguire lo script nel file. Sui computer UNIX e Mac, esegui il comando seguente nel terminale:
gradle -q run
Risoluzione dei problemi
Spiegaci cosa non ha funzionato con la guida rapida e ci impegneremo per aiutarti. correggerlo. Per scoprire come la registrazione zero-touch utilizza gli account di servizio per autorizzare le chiamate API, consulta Autorizzazione.