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

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

Requisitos previos

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

  • Una Cuenta de Google que pertenezca a tu revendedor de inscripción automática de servicio predeterminada. Si aún no te has incorporado, sigue los pasos que se indican en Cómo comenzar en la Guía del portal para revendedores.
  • 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. Configura ¿A qué datos accederás? en Datos de la aplicación.
  3. Haz clic en Siguiente. Se te pedirá que crees un servicio de servicio predeterminada.
  4. Asigna un nombre descriptivo al Nombre de la cuenta de servicio.
  5. Anota el ID de cuenta de servicio (parece una dirección de correo electrónico) porque usarla más tarde.
  6. Establece el Rol en Cuentas de servicio > Usuario de cuenta de servicio.
  7. Haz clic en Listo para terminar de crear la cuenta de servicio.
  8. Haz clic en la dirección de correo electrónico de la cuenta de servicio que creaste.
  9. Haz clic en **Claves**.
  10. Haz clic en **Agregar clave** y, luego, en **Crear clave nueva**.
  11. En **Key type**, selecciona **JSON**.
  12. Haz clic en Crear, y la clave privada se descargará en tu computadora.
  13. Haz clic en **Close**.
  14. Mueve el archivo a tu directorio de trabajo y cámbiale el nombre a service_account_key.json.
  1. Abre el portal de inscripción automática. Es posible que debas acceder.
  2. Haz clic en Servicio de servicio.
  3. Haz clic en Vincular cuenta de servicio.
  4. Configura la Dirección de correo electrónico como la dirección de la cuenta de servicio que creaste.
  5. Haz clic en Vincular cuenta de servicio para usar la cuenta de servicio con tu inscripción automática una cuenta de inscripción.

Paso 3: 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 4: Configura la muestra

  1. Arrastra service_account_key.json (descargado en el paso 1) al elemento visual. el Explorador de soluciones de Studio.
  2. Selecciona service_account_key.json y, luego, ve a la ventana Properties Configura el campo Copy to output directory como Siempre copiar.
  3. Reemplaza el contenido de Program.cs con el siguiente código.
  4. Ingrese su propio ID de socio revendedor como el valor de PartnerId (la primera línea de la app)
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 del socio

Por lo general, las llamadas a la API necesitan su ID de socio revendedor como argumento. Para encontrar tu ID de socio del portal de inscripción automática, sigue los pasos que se indican a continuación:

  1. Abre el portal. Es posible que debas acceder.
  2. Haz clic en Servicio de servicio.
  3. Copia el número de ID de socio que aparece en la línea Tu ID de revendedor.

Paso 5: Ejecuta la muestra

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

Soluciona problemas

Cuéntanos qué salió mal en la guía de inicio rápido y trabajaremos para y solucionar el problema. Para descubrir cómo la inscripción automática usa cuentas de servicio para autorizar llamadas a la API, consulta Autorización.

Más información