Guide de démarrage rapide .NET pour les clients

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

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 client d'inscription sans contact. Consultez la section Comptes client.
  • 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. Cliquez sur Annuler dans la boîte de dialogue "Créer des identifiants".
  3. En haut de la page, sélectionnez l'onglet OAuth consent screen (Écran d'autorisation OAuth). Sélectionnez une adresse e-mail, saisissez un nom de produit (Product name) si ce n'est pas déjà fait, puis cliquez sur le bouton Save (Enregistrer).
  4. Sélectionnez l'onglet Identifiants, cliquez sur le bouton Créer des identifiants, puis sélectionnez ID client OAuth.
  5. Sélectionnez le type d'application Other, saisissez le nom "quickstart", puis cliquez sur le bouton Create.
  6. Cliquez sur OK pour fermer le panneau Client OAuth.
  7. Cliquez sur Télécharger au format JSON.
  8. Déplacez le fichier dans votre répertoire de travail et renommez-le client_secret.json.

Étape 2: Préparez le projet

  1. Créez un projet Application Console .NET Core C# dans Visual Studio.
  2. Ouvrez le gestionnaire de packages, sélectionnez la source du package nuget.org et 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 3: Configurez l'exemple

  1. Faites glisser client_secret.json (téléchargé à l'étape 1) dans l'Explorateur de solutions de Visual Studio.
  2. Sélectionnez client_secret.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 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 Google.Apis.Util.Store;
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)
        {
            UserCredential credential;

            // Ask the user to authorize the request using their Google Account
            // in their browser.
            using (var stream =
                new FileStream("client_secret.json", FileMode.Open, FileAccess.Read))
            {
                string credPath = System.Environment.GetFolderPath(
                    System.Environment.SpecialFolder.Personal);
                credPath = Path.Combine(credPath, ".credentials/zero-touch.quickstart.json");

                credential = GoogleWebAuthorizationBroker.AuthorizeAsync(
                    GoogleClientSecrets.FromStream(stream).Secrets,
                    Scopes,
                    "user",
                    CancellationToken.None,
                    new FileDataStore(credPath, true)).Result;
                Console.WriteLine("Credential file saved to: " + credPath);
            }

            // 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 Démarrer dans la barre d'outils de Visual Studio.

La première fois que vous exécutez l'application, vous devez autoriser l'accès:

  1. L'application essaie d'ouvrir un nouvel onglet dans votre navigateur par défaut. Si cela ne fonctionne pas, copiez l'URL à partir de la console et ouvrez-la dans votre navigateur. Si vous n'êtes pas encore connecté à votre compte Google, vous êtes invité à le faire. Si vous êtes connecté à plusieurs comptes Google, la page vous invite à sélectionner un compte pour l'autorisation.
  2. Cliquez sur Accepter.
  3. Fermez l'onglet du navigateur. L'application continue de fonctionner.

Notes

  • Étant donné que la bibliothèque cliente des API Google stocke les données d'autorisation dans le système de fichiers, les lancements suivants ne vous demanderont pas d'autorisation.
  • Pour réinitialiser les données d'autorisation de l'application, supprimez le fichier ~/.credentials/zero-touch.quickstart.json, puis exécutez à nouveau l'application.
  • Le flux d'autorisation de ce guide de démarrage rapide est idéal pour une application de ligne de commande. Pour savoir comment ajouter une autorisation à une application Web, consultez Utiliser OAuth 2.0, applications Web (ASP.NET MVC).

Dépannage

Voici quelques vérifications courantes à effectuer. Signalez-nous le problème lié au guide de démarrage rapide. Nous nous efforcerons de le résoudre.

  • Vérifiez que vous autorisez les appels d'API avec le compte Google qui est membre de votre compte client d'inscription sans contact. Essayez de vous connecter au portail d'inscription sans contact avec le même compte Google pour tester votre accès.
  • Vérifiez que le compte a accepté les dernières conditions d'utilisation sur le portail. Consultez Comptes client.

En savoir plus