Service account

I service account 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 chiave accessibile soltanto dalla tua applicazione. Questa guida spiega come accedere all'API Content for Shopping con i service account.

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

Passaggi per utilizzare un service account per accedere all'API Content for Shopping

  1. Genera le credenziali del service account o accedi a quelle 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 dal menu a discesa nella parte superiore della pagina. Se non ne hai ancora uno, creane uno facendo clic su NUOVO PROGETTO.
    3. Se non hai ancora abilitato l'API Content for Shopping per questo progetto, cercala nell'elenco delle API di Google e abilitala.
    4. Fai clic sul menu di navigazione (☰) in alto a sinistra, seleziona API e servizi e poi Credenziali.
    5. Per configurare un service account, seleziona CREA CREDENZIALI e poi Service account.
    6. Assegna un nome al nuovo service account. Questo funge anche da nome utente predefinito per l'ID service account. Registra l'ID service account, inclusa la parte dopo il carattere "@", per un utilizzo successivo. Fai clic su CREA, poi segui i passaggi facoltativi per concedere l'accesso al progetto e agli utenti e fai clic su FINE.

      La scelta del ruolo per il service account non influirà sulle chiamate che possono essere effettuate all'API Content, in quanto l'accesso ai metodi dell'API Content è determinato invece dal ruolo associato all'ID service account in Merchant Center. Se non sai cosa scegliere, seleziona Progetto > Visualizzatore.

    7. Verrà visualizzata la pagina Account di servizio, in cui è possibile accedere al nuovo account di servizio.
    8. Per ottenere una chiave privata JSON, fai clic sul service account, quindi sulla scheda CHIAVI. Fai clic su AGGIUNGI CHIAVE > Crea nuova chiave e poi seleziona JSON come tipo di chiave. Fai clic su CREA per scaricare la chiave privata sul tuo 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 tuo cliente di eseguire questo passaggio.
    1. Vai al tuo account Merchant Center.
    2. Vai ad Accesso all'account nelle impostazioni del tuo account Merchant Center.
    3. Fai clic su + Aggiungi utente e utilizza l'ID service account come indirizzo email del nuovo utente.

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

    4. Specifica le preferenze di accesso utente e notifiche email per il service account. Tieni presente che l'utilizzo del servizio Accounts richiede l'accesso amministrativo.
    5. Fai clic su Aggiungi utente per salvare le preferenze e tornare all'elenco di utenti. L'ID service account 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 il service account tramite il flusso delle credenziali predefinite dell'applicazione Google o direttamente tramite il flusso del service account. Gli esempi dell'API Content for Shopping mostrano come utilizzare entrambi i flussi per le credenziali del service account in ogni linguaggio di programmazione supportato. Dai un'occhiata agli esempi di codice per provare il tuo nuovo service account e per scoprire quali modifiche dovrai apportare per utilizzare i service account nel tuo codice.

Domande frequenti

Posso accedere all'interfaccia utente di Merchant Center con il mio account di servizio?
No, i service account non sono Account Google regolari e non possono accedere all'interfaccia utente di Merchant Center.
Con quale frequenza devo aggiornare i token di accesso del service account?
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.