Suivez les étapes de ce guide de démarrage rapide. Vous disposerez d'une application de ligne de commande Java simple en 10 minutes environ, qui envoie des requêtes à l'API d'inscription sans contact.
Prérequis
Pour exécuter ce guide de démarrage rapide, vous aurez besoin des éléments suivants:
- Un compte Google membre de votre compte revendeur d'inscription sans contact. Si vous ne l'avez pas encore fait, suivez la procédure Premiers pas dans le Guide du portail des revendeurs.
- Java 1.7 ou version ultérieure
- Gradle 2.3 ou version ultérieure
- Accès à Internet et à un navigateur Web
Étape 1: Activez l'API d'inscription sans contact
- Utilisez cet assistant pour créer ou sélectionner un projet dans la Google Developers Console et activer automatiquement l'API. Cliquez sur Continuer, puis sur Accéder aux identifiants.
- Sélectionnez Données auxquelles vous allez accéder sur Données des applications.
- Cliquez sur Suivant. Vous devriez être invité à créer un compte de service.
- Attribuez un nom descriptif au nom du compte de service.
- Notez l'ID de compte de service (il ressemble à une adresse e-mail), car vous en aurez besoin ultérieurement.
- Définissez Rôle sur Comptes de service > Utilisateur du compte de service.
- Cliquez sur OK pour terminer la création du compte de service.
- Cliquez sur l'adresse e-mail du compte de service créé.
- Cliquez sur **Keys** (Clés).
- Cliquez sur **Ajouter une clé**, puis sur **Créer une clé**.
- Dans le champ **Type de clé**, sélectionnez **JSON**.
- Cliquez sur Créer. La clé privée est alors téléchargée sur votre ordinateur.
- Cliquez sur **Fermer**.
- Déplacez le fichier dans votre répertoire de travail et renommez-le
service_account_key.json
.
Étape 2: Associez le compte de service
- Ouvrez le portail d'inscription sans contact. Vous devrez peut-être vous connecter.
- Cliquez sur Comptes de service.
- Cliquez sur Associer le compte de service.
- Définissez l'adresse e-mail sur l'adresse du compte de service que vous avez créé.
- Cliquez sur Associer le compte de service pour utiliser le compte de service avec votre compte d'inscription sans contact.
Étape 3: Préparez le projet
Suivez la procédure ci-dessous pour configurer votre projet Gradle:
Exécutez la commande suivante pour créer un projet dans le répertoire de travail:
gradle init --type basic mkdir -p src/main/java src/main/resources
Copiez le fichier
service_account_key.json
que vous avez téléchargé à l'étape 1 dans le répertoiresrc/main/resources/
que vous avez créé ci-dessus.Ouvrez le fichier
build.gradle
par défaut et remplacez son contenu par le code suivant: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:+' }
Étape 4: Configurez l'exemple
Créez un fichier nommé src/main/java/ResellerQuickstart.java
, copiez le code suivant et enregistrez-le. Insérez votre propre ID de partenaire revendeur comme valeur pour PARTNER_ID
(première ligne de l'application).
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 du partenaire
Les appels d'API nécessitent généralement votre ID de partenaire revendeur en tant qu'argument. Pour trouver votre ID de partenaire sur le portail d'inscription sans contact, procédez comme suit:
- Ouvrez le portail. Vous devrez peut-être vous connecter.
- Cliquez sur Comptes de service.
- Copiez votre identifiant de partenaire sur la ligne Votre ID de revendeur.
Étape 5: Exécutez l'exemple
Utilisez l'aide de votre système d'exploitation pour exécuter le script dans le fichier. Sur les ordinateurs UNIX et Mac, exécutez la commande ci-dessous dans votre terminal:
gradle -q run
Dépannage
Signalez-nous le problème rencontré et nous nous efforcerons de le corriger. Pour savoir comment utiliser des comptes de service pour autoriser les appels d'API sans contact, consultez la section Autorisation.