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 di un utente. Utilizza invece un file chiave accessibile soltanto dalla tua applicazione. Questa guida illustra come accedere all'API Content 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 ha bisogno di accedere agli account Merchant Center dei tuoi clienti, consulta la guida sulle richieste di autorizzazione.

Prerequisiti

Procedura per utilizzare un account di servizio per accedere all'API Content 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, creane uno facendo clic su NUOVO PROGETTO.
    3. Se non hai già abilitato l'API Content for Shopping per questo progetto, cercala nell'elenco delle API di Google e abilitala.
    4. Nella barra laterale a sinistra, seleziona Credenziali. Per visualizzarla, potrebbe essere necessario fare clic sulla freccia rivolta verso sinistra in alto a sinistra.
    5. Per configurare un account di servizio, seleziona CREA CREDENZIALI, quindi Account di servizio.
    6. Assegnare un nome al nuovo account di servizio. Inoltre, funge da nome utente predefinito per l'ID account di servizio. Registra l'ID account di servizio, inclusa la parte dopo il carattere "@", per utilizzarlo in un secondo momento. Fai clic su CREA, segui i passaggi facoltativi per concedere l'accesso al progetto e agli utenti e fai clic su FINE.

      La scelta del ruolo per l'account di servizio non ha alcun effetto sulle chiamate che è possibile effettuare all'API Content, in quanto l'accesso ai metodi dell'API è determinato invece 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, in cui potrai accedere al nuovo account di servizio.
    8. Per ottenere una chiave privata JSON, fai clic sull'account di servizio, quindi sulla scheda CHIAVI. 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 eseguire questo passaggio al posto tuo.
    1. Accedi 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 account di servizio come indirizzo email per il nuovo utente.

      Se non hai preso nota dell'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 per Accesso utente e Notifiche via email per l'account di servizio. Tieni presente che l'utilizzo del servizioAccounts richiede l'accesso Amministratore.
    5. Fai clic su Aggiungi utente per salvare le preferenze e tornare all'elenco di utenti. L'ID account di servizio deve essere elencato con il ruolo dell'utente scelto.
    6. Ripeti la procedura per tutti gli altri account di servizio da aggiungere.
  3. Ora puoi accedere al tuo account Merchant Center utilizzando l'account di servizio tramite il flusso Credenziali predefinite dell'applicazione Google o tramite il flusso dell'account di servizio. Gli esempi dell'API Content for Shopping mostrano come utilizzare entrambi i flussi per le credenziali degli account di servizio in ogni linguaggio di programmazione supportato. Consulta gli esempi di codice per provare il nuovo account di servizio e scoprire quali modifiche dovrai apportare 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 normali Account Google e non possono accedere all'interfaccia utente di Merchant Center.
Con quale frequenza devo aggiornare i token di accesso all'account di servizio?
I token di accesso scadono un'ora dopo essere stati emessi dal server di autorizzazione OAuth 2.0 di Google. Quando un token di accesso scade, l'applicazione deve utilizzare la libreria client per recuperare un altro token di accesso.