Utilizzare gli account di servizio OAuth 2.0 con l'API Manufacturer Center

Gli account di servizio sono Account Google speciali che possono essere utilizzati dalle applicazioni per accedere alle API di Google in modo programmatico tramite OAuth 2.0. Un account di servizio utilizza un flusso OAuth 2.0 che non richiede autorizzazioni aggiuntive. Utilizza invece un file chiave accessibile solo alla tua applicazione. Questa guida illustra come accedere all'API Manufacturer Center con gli account di servizio.

Nota: le applicazioni che utilizzano account di servizio per l'autenticazione possono accedere solo al tuo account Manufacturer Center. Se stai scrivendo un'applicazione di terze parti che deve accedere agli account Manufacturer Center dei tuoi clienti, consulta la guida Autorizzazione delle richieste.

Prerequisiti

• Un account Manufacturer Center.

Procedura per utilizzare un account di servizio per accedere all'API Manufacturer Center

1. Genera le credenziali dell'account di servizio o accedi alle credenziali pubbliche che hai già generato. Dovrai creare un ID client OAuth 2.0 e ottenere un file di chiave privata *.json:

   1. Vai alla console dell'API di Google.

   2. Seleziona un progetto nel menu a discesa nella parte superiore della pagina. Se non ne hai ancora uno, creane uno facendo clic su Crea progetto.

   3. Se non hai già abilitato l'API Manufacturer Center per questo progetto, cercala nell'elenco delle API di Google e abilitala.

   4. Nella barra laterale a sinistra, seleziona Credentials (Credenziali).

   5. Per configurare un account di servizio, seleziona Crea credenziali, quindi Chiave account di servizio.

   

   1. Nella pagina successiva, seleziona Nuovo account di servizio dall'elenco a discesa.

   2. Assegna un nome al nuovo account di servizio. Serve anche da nome utente predefinito per l'ID account di servizio. Memorizza l'ID dell'account di servizio per utilizzarlo in un secondo momento.

   Nota: la scelta del ruolo per l'account di servizio non influisce sulle chiamate che è possibile effettuare all'API Manufacturer Center, in quanto l'accesso ai metodi dell'API Manufacturer Center è determinato invece dal ruolo associato all'ID account di servizio in Manufacturer Center. Se non sai cosa scegliere, scegli Project◄Viewer.

   

   1. Seleziona JSON come tipo di chiave, quindi fai clic su Crea.

   2. Il pulsante Crea cambierà in Creazione in corso... e, al termine della generazione della chiave, la chiave privata verrà scaricata automaticamente come file *.json.

   Importante: proteggi il file della chiave *.json che consente a un account di servizio di accedere ai servizi Google per i quali è stato autorizzato. È buona norma consentire agli account di servizio di accedere a una sola API di Google ciascuno. Si tratta di una misura preventiva per mitigare la quantità di dati a cui un utente malintenzionato può accedere nel caso in cui il file di chiave *.json dell'account di servizio sia compromesso.
   1. Tornerai alla pagina Credenziali, dove dovresti vedere il nuovo account di servizio nell'elenco delle chiavi dell'account di servizio.

2. Aggiungi il nuovo account di servizio come utente al tuo account Manufacturer Center. Se sei uno sviluppatore di terze parti, dovrai chiedere al cliente di eseguire questa operazione al posto tuo.

   1. Accedi al tuo account Manufacturer Center.

   2. Vai all'elenco "Utenti" nelle impostazioni del tuo account Manufacturer Center.

   3. Fai clic sul pulsante +Utente e utilizza l'ID account di servizio come indirizzo email per il nuovo utente.

      

   4. Compila il modulo con l'ID account di servizio e seleziona i ruoli utente che ti interessano. Devi sceglierne almeno uno e l'utilizzo del servizio Accounts richiede il ruolo Amministratore.

   Se non hai preso nota dell'ID account di servizio in precedenza, vai alla pagina di amministrazione Account di servizio e seleziona il progetto che hai creato.

   

   1. Fai clic sul pulsante Salva. Tornerai all'elenco degli utenti e l'ID dell'account di servizio dovrebbe essere elencato con i ruoli utente selezionati.

   2. Ripeti la procedura per tutti gli altri account di servizio che vuoi aggiungere.

   3. Per visualizzare gli utenti con account di servizio esistenti, vai alla scheda Utenti. Si tratta degli utenti con un indirizzo email che termina con "gserviceaccount.com".

3. Ora puoi accedere al tuo account Manufacturer Center tramite l'account di servizio tramite il flusso Credenziali predefinite dell'applicazione Google o direttamente tramite il flusso dell'account di servizio. Gli esempi dell'API Manufacturer Center mostrano come utilizzare entrambi i flussi per le credenziali dell'account di servizio in ogni linguaggio di programmazione supportato. Guarda gli esempi di codice per provare il tuo nuovo account di servizio e conoscere le modifiche necessarie per utilizzare gli account di servizio nel tuo codice.

Domande frequenti.

Posso accedere all'interfaccia utente web di Manufacturer Center con il mio account di servizio?

No, gli account di servizio non sono dei normali Account Google e non possono accedere all'interfaccia utente web di Manufacturer Center.

Con quale frequenza devo aggiornare i token di accesso all'account di servizio?

I token di accesso scadono un'ora dopo l'emissione da parte del server di autorizzazione Google OAuth 2.0. Quando un token di accesso scade, l'applicazione deve utilizzare la libreria client per recuperare un altro token di accesso.