Guida rapida di .NET per i rivenditori

Seguite i passaggi di questa guida rapida e in circa 10 minuti avrete una semplice app della console .NET C# che invia richieste alla registrazione zero-touch l'API del rivenditore.

Prerequisiti

Per eseguire questa guida rapida, ti serviranno:

  • Un Account Google, che sia un membro del tuo rivenditore per la registrazione zero-touch . Se non hai ancora effettuato l'onboarding, segui i passaggi descritti in Inizia in la guida del Portale rivenditori.
  • Visual Studio 2013 o versioni successive.
  • Accesso a internet e a un browser web.

Passaggio 1: attiva l'API per la registrazione zero-touch

  1. Usa questo guidata per creare o selezionare un progetto in Google Developers Console e attivare automaticamente l'API. Fai clic su Continua, quindi su Vai alle credenziali.
  2. Imposta A quali dati hai accesso? su Dati applicazione.
  3. Fai clic su Avanti. Viene richiesto di creare un servizio .
  4. Assegna un nome descrittivo a Nome account di servizio.
  5. Prendi nota dell'ID account di servizio (assomiglia a un indirizzo email) perché in un secondo momento.
  6. Imposta Ruolo su Account di servizio > Utente account di servizio.
  7. Fai clic su Fine per completare la creazione dell'account di servizio.
  8. Fai clic sull'indirizzo email dell'account di servizio che hai creato.
  9. Fai clic su **Chiavi**.
  10. Fai clic su **Aggiungi chiave** e poi su **Crea nuova chiave**.
  11. Per **Tipo di chiave**, seleziona **JSON**.
  12. Fai clic su Crea per scaricare la chiave privata sul tuo computer.
  13. Fai clic su **Chiudi**.
  14. Sposta il file nella directory di lavoro e rinominalo service_account_key.json.
  1. Apri il portale per la registrazione zero-touch. Potresti dover eseguire l'accesso.
  2. Fai clic su Servizio Google Cloud.
  3. Fai clic su Collega account di servizio.
  4. Imposta Indirizzo email sull'indirizzo dell'account di servizio che hai creato.
  5. Fai clic su Collega account di servizio per usare l'account di servizio con la registrazione zero-touch. dell'account di registrazione.

Passaggio 3: prepara il progetto

  1. Crea un nuovo progetto dell'applicazione console .NET Core C# in Visual Studio.
  2. Apri Gestione pacchetti, seleziona l'origine del pacchetto nuget.org e aggiungi i seguenti pacchetti:
    • Google.Apis.AndroidProvisioningPartner.v1
    • Google.Apis.Auth

Per saperne di più, leggi il documento Microsoft Installa e utilizza un pacchetto.

Passaggio 4: configura l'anteprima

  1. Trascina service_account_key.json (scaricato nel passaggio 1) nell'immagine Esplora soluzioni di Studio.
  2. Seleziona service_account_key.json, poi vai alla finestra Proprietà e imposta il campo Copia nella directory di output su Copia sempre.
  3. Sostituisci i contenuti di Program.cs con il codice che segue.
  4. Inserisci il tuo ID rivenditore partner come valore per PartnerId (prima riga dell'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 partner

In genere, per le chiamate API è necessario l'ID rivenditore partner come argomento. Per trovare ID partner dal portale della registrazione zero-touch, segui questi passaggi:

  1. Apri il portale. Potresti dover eseguire l'accesso.
  2. Fai clic su Servizio Google Cloud.
  3. Copia il tuo ID partner dalla riga Il tuo ID rivenditore.

Passaggio 5: esegui l'esempio

Per creare ed eseguire l'esempio, fai clic su Avvia nella barra degli strumenti di Visual Studio.

Risoluzione dei problemi

Spiegaci cosa non ha funzionato con la guida rapida e ci impegneremo per aiutarti. correggerlo. Per scoprire come la registrazione zero-touch utilizza gli account di servizio per autorizzare le chiamate API, consulta Autorizzazione.

Scopri di più