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
- 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
- Configura ¿A qué datos accederás? en Datos de la aplicación.
- Haz clic en Siguiente. Se te pedirá que crees un servicio de servicio predeterminada.
- Asigna un nombre descriptivo al Nombre de la cuenta de servicio.
- Anota el ID de cuenta de servicio (parece una dirección de correo electrónico) porque usarla más tarde.
- Establece el Rol en Cuentas de servicio > Usuario de cuenta de servicio.
- Haz clic en Listo para terminar de crear la cuenta de servicio.
- Haz clic en la dirección de correo electrónico de la cuenta de servicio que creaste.
- Haz clic en **Claves**.
- Haz clic en **Agregar clave** y, luego, en **Crear clave nueva**.
- En **Key type**, selecciona **JSON**.
- Haz clic en Crear, y la clave privada se descargará en tu computadora.
- Haz clic en **Close**.
- Mueve el archivo a tu directorio de trabajo y cámbiale el nombre a
service_account_key.json
.
Paso 2: Vincula la cuenta de servicio
- Abre el portal de inscripción automática. Es posible que debas acceder.
- Haz clic en Servicio de servicio.
- Haz clic en Vincular cuenta de servicio.
- Configura la Dirección de correo electrónico como la dirección de la cuenta de servicio que creaste.
- 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
- Crea un proyecto nuevo de aplicación de la consola .NET Core C# en Visual Studio.
- 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
- Arrastra
service_account_key.json
(descargado en el paso 1) al elemento visual. el Explorador de soluciones de Studio. - Selecciona
service_account_key.json
y, luego, ve a la ventana Properties Configura el campo Copy to output directory como Siempre copiar. - Reemplaza el contenido de
Program.cs
con el siguiente código. - 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:
- Abre el portal. Es posible que debas acceder.
- Haz clic en Servicio de servicio.
- 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.