Guide de démarrage rapide .NET pour les revendeurs

Suivez les étapes de ce guide de démarrage rapide. En 10 minutes environ, vous aurez une application de console .NET C# simple qui envoie des requêtes à l'API de revendeur d'enregistrement sans contact.

Prérequis

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

  • Un compte Google, membre de votre compte revendeur d'enregistrement sans contact. Si vous n'avez pas encore intégré le portail, suivez les étapes de la section Premiers pas du guide du portail pour les revendeurs.
  • Visual Studio 2013 ou version ultérieure
  • Accès à Internet et à un navigateur Web.

Étape 1 : Activez l'API d'inscription sans contact

  1. Utilisez cet assistant pour créer ou sélectionner un projet dans la Google Developers Console et activer automatiquement l'API. Cliquez sur Continue (Continuer), puis sur Go to credentials (Accéder à Identifiants).
  2. Définissez À quelles données accéderez-vous ? sur Données d'application.
  3. Cliquez sur Suivant. Vous devriez être invité à créer un compte de service.
  4. Attribuez un nom descriptif à Nom du compte de service.
  5. Notez l'ID de compte de service (qui ressemble à une adresse e-mail), car vous en aurez besoin plus tard.
  6. Définissez Rôle sur Comptes de service > Utilisateur du compte de service.
  7. Cliquez sur OK pour terminer la création du compte de service.
  8. Cliquez sur l'adresse e-mail du compte de service créé.
  9. Cliquez sur **Clés**.
  10. Cliquez sur "Ajouter une clé", puis sur "Créer une clé".
  11. Pour "Type de clé", sélectionnez "JSON".
  12. Cliquez sur Créer. La clé privée est alors téléchargée sur votre ordinateur.
  13. Cliquez sur "Fermer".
  14. Déplacez le fichier vers votre répertoire de travail et renommez-le service_account_key.json.
  1. Ouvrez le portail d'enregistrement sans contact. Pour cela, vous devrez peut-être vous connecter.
  2. Cliquez sur Comptes de service.
  3. Cliquez sur Associer le compte de service.
  4. Définissez le champ Adresse e-mail sur l'adresse du compte de service que vous avez créé.
  5. Cliquez sur Associer le compte de service pour utiliser le compte de service avec votre compte d'enregistrement sans contact.

Étape 3 : Préparer le projet

  1. Créez un projet Application console C# .NET Core dans Visual Studio.
  2. Ouvrez le Gestionnaire de paquets, sélectionnez la source de paquets nuget.org, puis ajoutez les paquets suivants :
    • Google.Apis.AndroidProvisioningPartner.v1
    • Google.Apis.Auth

Pour en savoir plus, consultez le document Microsoft Installer et utiliser un package.

Étape 4 : Configurer l'exemple

  1. Faites glisser service_account_key.json (téléchargé à l'étape 1) dans l'explorateur de solutions Visual Studio.
  2. Sélectionnez service_account_key.json, puis accédez à la fenêtre "Propriétés" et définissez le champ Copier dans le répertoire de sortie sur Toujours copier.
  3. Remplacez le contenu de Program.cs par le code suivant.
  4. Insérez votre propre ID de partenaire revendeur comme valeur pour PartnerId (première ligne de l'application).
using Google.Apis.AndroidProvisioningPartner.v1;
using Google.Apis.AndroidProvisioningPartner.v1.Data;
using Google.Apis.Auth.OAuth2;
using Google.Apis.Services;
using System;
using System.Collections.Generic;
using System.IO;

namespace ZeroTouchResellerQuickstart
{
    class Program
    {
        // TODO: replace this with your partner reseller ID.
        static long PartnerId = 11036885;

        // Use a single scope for the all methods in the reseller API.
        static readonly string[] Scopes =
        { "https://www.googleapis.com/auth/androidworkprovisioning" };
        static string ApplicationName = "Zero-touch Reseller .NET Quickstart";

        static void Main(string[] args)
        {
            // Create a credential to authorize API requests using a service account key.
            // The service account must be linked using the zero-touch portal.
            ServiceAccountCredential credential;
            using (var stream =
                new FileStream("service_account_key.json", FileMode.Open, FileAccess.Read))
            {
                credential = GoogleCredential.FromStream(stream)
                                     .CreateScoped(Scopes)
                                     .UnderlyingCredential as ServiceAccountCredential;
            }

            // Create a zero-touch enrollment API service endpoint.
            var service = new AndroidProvisioningPartnerService(new BaseClientService.Initializer
            {
                HttpClientInitializer = credential,
                ApplicationName = ApplicationName
            });

            // Send an API request to list all our customers.
            PartnersResource.CustomersResource.ListRequest request =
                service.Partners.Customers.List(PartnerId);
            ListCustomersResponse response = request.Execute();

            // Print out the details of each customer.
            IList<Company> customers = response.Customers;
            if (customers != null)
            {
                foreach (Company customer in customers)
                {
                    Console.WriteLine("Name:{0}  ID:{1}",
                                      customer.CompanyName,
                                      customer.CompanyId);
                }
            }
            else
            {
                Console.WriteLine("No customers found");
            }
        }
    }
}

ID du partenaire

Les appels d'API nécessitent généralement votre ID de partenaire revendeur comme argument. Pour trouver votre ID de partenaire dans le portail d'inscription sans contact, procédez comme suit :

  1. Ouvrez le portail. Pour cela, vous devrez peut-être vous connecter.
  2. Cliquez sur  Comptes de service.
  3. Copiez votre numéro d'ID de partenaire sur la ligne Votre ID de revendeur.

Étape 5 : Exécuter l'exemple

Pour créer et exécuter l'exemple, cliquez sur Start (Démarrer) dans la barre d'outils de Visual Studio.

Dépannage

Expliquez-nous le problème dans le guide de démarrage rapide. Nous nous efforcerons de le résoudre. Pour découvrir comment l'enregistrement sans contact utilise les comptes de service pour autoriser les appels d'API, consultez la section Autorisation.

En savoir plus