Account di servizio

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 l'autorizzazione umana. Utilizza invece un file della chiave accessibile solo dall'applicazione. Questa guida descrive come accedere alla Content API for Shopping con gli account di servizio.

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

Prerequisiti

Procedura per utilizzare un account di servizio per accedere a Content API for Shopping

  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 della 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, fai clic su NUOVO PROGETTO per crearne uno.
    3. Se non hai ancora abilitato la Content API for Shopping per questo progetto, cercala nell'elenco delle API di Google e abilitala.
    4. Nella barra laterale a sinistra, seleziona Credenziali. Per vedere la scelta, potrebbe essere necessario fare clic sulla freccia rivolta verso sinistra in alto a sinistra.
    5. Per configurare un account di servizio, seleziona CREA CREDENZIALE, quindi Account di servizio.
    6. Assegna un nome al nuovo account di servizio. Viene utilizzato anche come nome utente predefinito per l'ID account di servizio. Registra l'ID dell'account di servizio, inclusa la parte dopo il carattere "@", per utilizzarlo in seguito. Fai clic su CREA, quindi segui i passaggi facoltativi per concedere l'accesso a progetti e utenti e fai clic su FINE.

      La scelta del ruolo per l'account di servizio non influisce sulla chiamata che può essere effettuata a Content API, poiché l'accesso ai metodi di Content API viene determinato dal ruolo associato all'ID account di servizio in Merchant Center. Se hai dubbi su cosa scegliere, seleziona Progetto > Visualizzatore.

    7. Verrà visualizzata la pagina Account di servizio, dove puoi accedere al tuo nuovo account di servizio.
    8. Per ottenere una chiave privata JSON, fai clic sull'account di servizio, quindi sulla scheda CHIAVE. Fai clic su AGGIUNGI CHIAVE > Crea nuova chiave, quindi seleziona JSON come tipo di chiave. Fai clic su CREA per scaricare la chiave privata sul computer.
  2. Aggiungi il nuovo account di servizio come utente al tuo account Merchant Center. Se sei uno sviluppatore di terze parti, dovrai chiedere al cliente di farlo per te.
    1. Accedi al tuo account Merchant Center.
    2. Vai su Accesso all'account nelle impostazioni del tuo account Merchant Center.
    3. Fai clic su + Aggiungi utente e utilizza l'ID account di servizio come indirizzo email del nuovo utente.

      Se non hai annotato l'ID account di servizio in precedenza, vai alla pagina di amministrazione degli account di servizio e seleziona il progetto che hai creato.

    4. Specifica le preferenze di Accesso utente e Notifiche email per l'account di servizio. Tieni presente che l'utilizzo del servizio Accounts richiede l'accesso come Amministratore.
    5. Fai clic su Aggiungi utente per salvare le preferenze e tornare all'elenco di utenti. L'ID dell'account di servizio deve essere elencato con il ruolo utente scelto.
    6. Ripeti la procedura per tutti gli altri account di servizio che vuoi aggiungere.
  3. Ora puoi accedere al tuo account Merchant Center utilizzando l'account di servizio sia direttamente tramite il flusso Credenziali predefinite dell'applicazione Google sia tramite il flusso dell'account di servizio. La Content API for Shopping Esempi mostra come utilizzare entrambi i flussi per le credenziali dell'account di servizio in ogni linguaggio di programmazione supportato. Dai un'occhiata agli esempi di codice per provare il tuo nuovo account di servizio e per sapere quali modifiche saranno necessarie per utilizzare gli account di servizio nel tuo codice.

Domande frequenti

Posso accedere all'interfaccia utente di Merchant Center con il mio account di servizio?
No, gli account di servizio non sono Account Google standard e non possono accedere all'interfaccia utente di Merchant Center.
Con quale frequenza devo aggiornare i token di accesso dell'account di servizio?
I token di accesso scadono un'ora dopo l'emissione dal server di autorizzazione Google OAuth 2.0. Alla scadenza di un token di accesso, l'applicazione deve utilizzare la libreria client per recuperare un altro token di accesso.