Guide de démarrage rapide .NET pour les revendeurs

Suivez les étapes de ce guide de démarrage rapide. En 10 minutes environ, vous disposerez Une application de console .NET C# simple qui envoie des requêtes à l'enregistrement sans contact via l'API 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.
  • 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 Continuer, puis sur Accéder aux 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 service de service.
  4. Attribuez un nom descriptif au champ Nom du compte de service.
  5. Notez l'ID de compte de service (il ressemble à une adresse e-mail), car vous de l'utiliser 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. Dans **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 Service. Google Cloud.
  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 sans contact. compte d'enregistrement.

Étape 3: Préparer le projet

  1. Créez un projet d'application de console .NET Core C# dans Visual Studio.
  2. Ouvrez le gestionnaire de packages, sélectionnez la source du package nuget.org, puis ajoutez les packages 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, accédez à la fenêtre "Propriétés", puis 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 Service. Google Cloud.
  3. Copiez votre identifiant de partenaire à partir de la ligne Votre identifiant 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

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.

En savoir plus