Guide de démarrage rapide .NET pour les clients

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'enregistrement sans contact à l'aide d'un compte de service.

Prérequis

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

  • Un compte de service associé à votre compte client d'enregistrement sans contact. Consultez Premiers pas.
  • 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 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
  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 à 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 dans votre répertoire de travail et renommez-le service_account_key.json.

Étape 2: 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 3: Configurer l'exemple

  1. Faites glisser le service_account_key.json que vous avez téléchargé lors de la création de votre compte de service dans l'explorateur de solutions Visual 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 du fichier Program.cs par le code suivant :
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;
using System.Threading;

namespace ZeroTouchCustomerQuickstart
{
    class Program
    {
        // A single scope is used for the zero-touch enrollment customer API.
        static readonly string[] Scopes =
            { "https://www.googleapis.com/auth/androidworkzerotouchemm" };
        static string ApplicationName = "Zero-touch Enrollment .NET Quickstart";

        static void Main(string[] args)
        {
            GoogleCredential credential;

            // Authenticate using the service account key
            credential = GoogleCredential.FromFile("service_account_key.json")
                .CreateScoped(Scopes);

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

            // Get the customer's account. Because a customer might have more
            // than one, limit the results to the first account found.
            CustomersResource.ListRequest accountRequest = service.Customers.List();
            accountRequest.PageSize = 1;
            CustomerListCustomersResponse accountResponse = accountRequest.Execute();
            if (accountResponse.Customers.Count == 0)
            {
                // No accounts found for the user. Confirm the Google Account
                // that authorizes the request can access the zero-touch portal.
                Console.WriteLine("No zero-touch enrollment account found.");
                Environment.Exit(-1);
            }
            Company customer = accountResponse.Customers[0];
            var customerAccount = String.Format("customers/{0}", customer.CompanyId);


            // Send an API request to list all the DPCs available.
            CustomersResource.DpcsResource.ListRequest request = service.Customers.Dpcs.
                List(customerAccount);
            CustomerListDpcsResponse response = request.Execute();

            // Print out the details of each DPC.
            IList<Dpc> dpcs = response.Dpcs;
            foreach (Dpc dpcApp in dpcs)
            {
                Console.WriteLine("Name:{0}  APK:{1}",
                                  dpcApp.DpcName,
                                  dpcApp.PackageName);
            }

        }
    }
}

Étape 4: 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.

Remarques

  • Évitez de partager votre fichier service_account_key.json avec qui que ce soit. Attention de ne pas les inclure dans des référentiels de code source. Pour en savoir plus sur la gestion des secrets de compte de service, consultez nos conseils.

En savoir plus