Guía de inicio rápido de .NET para clientes

Sigue los pasos de esta guía de inicio rápido y, en unos 10 minutos, una aplicación sencilla de la consola .NET C# que realiza solicitudes de inscripción automática API del cliente.

Requisitos previos

Para ejecutar esta guía de inicio rápido, necesitas lo siguiente:

  • Tener una Cuenta de Google como miembro de tu cliente con inscripción automática de servicio predeterminada. Consulta la sección Descripción .
  • Visual Studio 2013 o una versión posterior
  • Acceso a Internet y un navegador web

Paso 1: Activa la API de inscripción automática

  1. Utiliza esto para crear o seleccionar un proyecto en Google Developers Console y activará automáticamente la API. Haga clic en Continuar y, luego, en Ir a Credenciales
  2. Haz clic en Cancelar en Crear credenciales.
  3. En la parte superior de la página, seleccione la pestaña OAuth consent screen. Selecciona un Dirección de correo electrónico, ingresa un Nombre del producto si aún no lo has configurado Haz clic en el botón Save.
  4. Selecciona la pestaña Credenciales y haz clic en Crear credenciales. y selecciona ID de cliente de OAuth.
  5. Selecciona el tipo de aplicación Otro y, luego, ingresa el nombre "Guía de inicio rápido" y haz clic en el botón Crear .
  6. Haz clic en Aceptar para descartar el panel Cliente de OAuth.
  7. Haz clic en Descargar JSON.
  8. Mueve el archivo a tu directorio de trabajo y cámbiale el nombre a client_secret.json.

Paso 2: Prepara el proyecto

  1. Crea un proyecto nuevo de aplicación de la consola .NET Core C# en Visual Studio.
  2. Abre el Administrador de paquetes, selecciona la fuente del paquete nuget.org y agrega los siguientes paquetes:
    • Google.Apis.AndroidProvisioningPartner.v1
    • Google.Apis.Auth

Para obtener más información, lee el documento de Microsoft Cómo instalar y usar una paquete.

Paso 3: Configura la muestra

  1. Arrastra client_secret.json (descargado en el paso 1) a Visual Studio. el Explorador de soluciones.
  2. Selecciona client_secret.json, ve a la ventana Properties y configura El campo Copiar en el directorio de salida debe ser Copiar siempre.
  3. Reemplaza el contenido de Program.cs con el código que se muestra a continuación:
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);
            }

        }
    }
}

Paso 4: Ejecuta la muestra

Para compilar y ejecutar la muestra, haz clic en Start en la barra de herramientas de Visual Studio.

La primera vez que ejecutes la app, deberás autorizar el acceso:

  1. La app intenta abrir una pestaña nueva en el navegador predeterminado. Si esto falla, copia la URL desde el la consola y ábrela en tu navegador. Si aún no accediste a tu Cuenta de Google, estás para acceder. Si accediste a varias Cuentas de Google, la página te solicitará que selecciones una cuenta para la autorización.
  2. Haz clic en Aceptar.
  3. Cierra la pestaña del navegador; la app seguirá ejecutándose.

Notas

  • Debido a que la biblioteca cliente de API de Google almacena datos de autorización en el sistema de archivos, las siguientes no requieren autorización.
  • Para restablecer los datos de autorización de la app, borra la ~/.credentials/zero-touch.quickstart.json y vuelve a ejecutar la app.
  • El flujo de autorización de esta guía de inicio rápido es ideal para una app de línea de comandos. Para aprender a agregar autorización a una aplicación web, consulta Cómo usar OAuth 2.0 y aplicaciones web (ASP.NET MVC)

Soluciona problemas

A continuación, se incluyen algunos aspectos comunes que deberás verificar. Cuéntanos qué salió mal en la guía de inicio rápido y trabajaremos para solucionarlo.

  • Asegúrate de estar autorizando llamadas a la API con la misma Cuenta de Google miembro de tu cuenta de cliente con inscripción automática. Intenta acceder al portal de inscripción automática con el misma Cuenta de Google para probar el acceso.
  • Confirma que la cuenta haya aceptado las Condiciones del Servicio más recientes en el portal. Consulta Cuentas de clientes.

Más información