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, qui est membre de votre compte revendeur d'enregistrement sans contact. Si vous n'avez pas encore effectué l'intégration, suivez les étapes de la section Premiers pas dans le guide du portail revendeur.
  • Visual Studio 2013 ou version ultérieure
  • Accès à Internet et à un navigateur Web.

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

  1. Utilisez ces instructions pour créer ou sélectionner un projet dans la Google Developers Console. activer automatiquement l'API. Cliquez sur Continue (Continuer), puis sur Go to credentials (Accéder à Identifiants).
  2. Définissez À quelles données allez-vous accéder ? sur Données d'application.
  3. Cliquez sur Suivant. Vous devriez être invité à créer un compte de service.
  4. Attribuez un nom descriptif au champ 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 téléchargée sur votre ordinateur.
  13. Cliquez sur **Fermer**.
  14. Déplacez le fichier dans 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 un 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 sans contact. compte d'enregistrement.

É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 votre visuel Explorateur de solutions 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 de 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 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:

  1. Ouvrez le portail. Pour cela, vous devrez peut-être vous connecter.
  2. Cliquez sur  Comptes de service.
  3. Copiez votre identifiant de partenaire à partir de la ligne Votre identifiant de revendeur.

Étape 5 : Exécuter l'exemple

Pour compiler et exécuter l'exemple, cliquez sur  Démarrer dans la barre d'outils de Visual Studio.

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 découvrir comment la fonctionnalité sans contact utilise des comptes de service pour autoriser les appels d'API, consultez la section Autorisation.

En savoir plus