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 dei rivenditori.
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
- 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.
- Imposta A quali dati hai accesso? su Dati applicazione.
- Fai clic su Avanti. Viene richiesto di creare un servizio .
- Assegna un nome descrittivo a Nome account di servizio.
- Prendi nota dell'ID account di servizio (assomiglia a un indirizzo email) perché lo utilizzerai in seguito.
- Imposta Ruolo su Account di servizio > Utente account di servizio.
- Fai clic su Fine per completare la creazione dell'account di servizio.
- Fai clic sull'indirizzo email dell'account di servizio che hai creato.
- Fai clic su **Chiavi**.
- Fai clic su **Aggiungi chiave**, quindi su **Crea nuova chiave**.
- Per **Tipo di chiave**, seleziona **JSON**.
- Fai clic su Crea e la chiave privata viene scaricata sul computer.
- Fai clic su **Chiudi**.
- Sposta il file nella directory di lavoro e rinominalo
service_account_key.json
.
Passaggio 2: collega l'account di servizio
- Apri il portale per la registrazione zero-touch. Potresti dover eseguire l'accesso.
- Fai clic su Servizio Google Cloud.
- Fai clic su Collega account di servizio.
- Imposta Indirizzo email sull'indirizzo dell'account di servizio che hai creato.
- 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
- Crea un nuovo progetto dell'applicazione console .NET Core C# in Visual Studio.
- 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
- Trascina
service_account_key.json
(scaricato nel passaggio 1) nella tua applicazione visiva Esplora soluzioni di Studio. - Seleziona
service_account_key.json
, poi vai alla finestra Proprietà e imposta il campo Copia nella directory di output su Copia sempre. - Sostituisci i contenuti di
Program.cs
con il codice che segue. - Inserisci il tuo ID partner rivenditore come valore per
PartnerId
(la 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:
- Apri il portale. Potresti dover eseguire l'accesso.
- Fai clic su Servizio Google Cloud.
- 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.