Cette page a été traduite par l'API Cloud Translation.

Guide de démarrage rapide de Java pour les revendeurs

Suivez les étapes de ce guide de démarrage rapide. En 10 minutes environ, vous disposerez une application de ligne de commande Java simple qui envoie des requêtes au l'API Enrollment Reseller.

Prérequis

Pour exécuter ce guide de démarrage rapide, vous avez besoin des éléments suivants:

Un compte Google appartenant à votre revendeur d'inscription sans contact de service. Si vous n'avez pas encore effectué l'intégration, suivez les étapes de la section Premiers pas dans le guide du portail revendeur.
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'enregistrement sans contact

Utilisez ces instructions pour créer ou sélectionner un projet dans la Google Developers Console. activer automatiquement l'API. Cliquez sur Continuer, puis sur Accéder aux identifiants
Définissez À quelles données accéderez-vous ? sur Données d'application.
Cliquez sur Suivant. Vous devriez être invité à créer un service de service.
Attribuez un nom descriptif au champ Nom du compte de service.
Notez l'ID de compte de service (il ressemble à une adresse e-mail), car vous de l'utiliser plus tard.
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 **Clés**.
Cliquez sur **Ajouter une clé**, puis sur **Créer une clé**.
Dans **Type de clé**, sélectionnez **JSON**.
Cliquez sur Créer. La clé privée est 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'enregistrement sans contact. Pour cela, vous devrez peut-être vous connecter.
Cliquez sur Service. Google Cloud.
Cliquez sur Associer le compte de service.
Définissez le champ 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 sans contact. compte d'enregistrement.

Étape 3: Préparer le projet

Suivez les étapes 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 fichier src/main/resources/ que vous avez créé précédemment.

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: Configurer l'exemple

Créez un fichier nommé src/main/java/ResellerQuickstart.java et copiez-y le le code suivant et enregistrez le fichier. Insérez votre propre partenaire revendeur ID comme valeur de PARTNER_ID (la 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 ont généralement besoin de votre ID de partenaire revendeur comme argument. Pour trouver votre ID de partenaire sur le portail d'enregistrement sans contact, suivez les étapes ci-dessous:

Ouvrez le portail. Pour cela, vous devrez peut-être vous connecter.
Cliquez sur Service. Google Cloud.
Copiez votre identifiant de partenaire à partir de la ligne Votre identifiant de revendeur.

Étape 5: Exécuter l'exemple

Utilisez l'aide de votre système d'exploitation pour exécuter le script dans le fichier. Sous UNIX et Mac sur votre ordinateur, exécutez la commande ci-dessous dans votre terminal:

gradle -q run

Dépannage

Dites-nous ce qui n'a pas fonctionné dans le guide de démarrage rapide afin que nous puissions vous aider. y remédier. Pour savoir comment l'enregistrement sans contact utilise les comptes de service pour autoriser les appels d'API, consultez Autorisation.