Configurare l'autenticazione per l'API Merchant

Per garantire la sicurezza dei dati, applicare il controllo degli accessi e mantenere l'integrità del sistema, devi autenticare tutte le richieste API Merchant. L'API utilizza l'identità autenticata per determinare le azioni che il chiamante è autorizzato a eseguire. Ad esempio, alcuni chiamanti potrebbero avere accesso di sola lettura ai dati di prodotto, mentre altri possono modificare le impostazioni dell'account in Merchant Center.

Questo documento fa parte di una serie di articoli sulla guida introduttiva dell'API Merchant. Se hai già configurato l'autenticazione con l'API Merchant, puoi passare alla sezione successiva: Registrati come sviluppatore arrow_forward

Autorizza le richieste all'API Merchant

Ogni richiesta inviata all'API Merchant deve includere un token di autorizzazione per identificare la tua applicazione su Google. Per configurare l'autenticazione e l'autorizzazione, decidi il caso d'uso che descrive meglio il modo in cui intendi utilizzare l'API Merchant:

Stai creando un'applicazione che verrà utilizzata da altre aziende?

In caso affermativo, utilizzi l'autorizzazione OAuth 2.0. Scegli l'autorizzazione OAuth 2.0 se:

• Sei un fornitore o un'agenzia di terze parti: stai creando un'applicazione, ad esempio una piattaforma SaaS, che verrà utilizzata da altre attività per gestire i propri dati di Merchant Center.
• Devi gestire molti account esterni: vuoi che una singola applicazione funzioni su più account Merchant Center indipendenti di proprietà di clienti diversi. I tuoi clienti concedono le autorizzazioni accedendo ai propri Account Google e facendo clic su "Consenti" in una schermata per il consenso.

Stai creando un'app per la tua attività?

In questo caso, utilizza un'autorizzazione del service account per ottenere l'accesso all'API Merchant. Scegli l'autorizzazione di un service account se:

• Stai creando la tua applicazione interna: stai sviluppando uno strumento specifico per la tua attività per gestire i tuoi dati di Merchant Center o vuoi che le credenziali appartengano all'applicazione stessa anziché a un utente individuale specifico.
• Hai bisogno di automazione senza accesso umano: la tua applicazione esegue attività in background, come aggiornamenti automatici dell'inventario o job "cron".

Autorizzazione OAuth 2.0

Se sei un fornitore di terze parti o un'agenzia che gestisce più account cliente, la tua applicazione deve utilizzare OAuth 2.0 per autorizzare le richieste. Segui questi passaggi per configurare OAuth 2.0 per l'API Merchant:

1. Crea le credenziali OAuth 2.0 in API e servizi nella console Google Cloud
2. Scarica le credenziali client OAuth2 nel file, ad esempio client-secrets.json
3. Aggiungi l'account email come utente a Merchant Center: assicurati che l'Account Google che utilizzi per autorizzare le richieste esista come utente in Merchant Center. Per maggiori dettagli, consulta Come aggiungere o rimuovere un utente da Merchant Center.
4. Assegnagli il ruolo Admin per eseguire la registrazione. Per saperne di più sui ruoli, consulta Gestisci persone e livelli di accesso in Merchant Center.
5. Configura l'autenticazione con esempi di codice: segui le indicazioni degli esempi di codice ufficiali nella sezione della documentazione Configurazione dell'autenticazione e della configurazione di esempio

Per saperne di più sull'autorizzazione OAuth 2.0, consulta Autorizza l'accesso di app di terze parti all'account Merchant Center e Utilizzare OAuth 2.0 per accedere alle API di Google.

Autorizzazione del service account

Utilizzi un service account per autorizzare l'accesso all'API Merchant al tuo account Merchant Center. Per configurare l'autorizzazione del service account per l'API Merchant:

1. Crea le credenziali del service account in API e servizi nella console Google Cloud
2. Scarica la chiave privata: crea e scarica la chiave privata in formato JSON per il service account. Rinomina il file in service-account.json
3. Aggiungi l'account di servizio a Merchant Center: copia l'indirizzo email univoco dell'account di servizio, ad esempio sa@project.iam.gserviceaccount.com, e aggiungilo come nuovo utente in Merchant Center. Per maggiori dettagli, consulta l'articolo Come aggiungere o rimuovere un utente da Merchant Center.
4. Assegnagli l'accesso Admin. Per saperne di più sui livelli di accesso, consulta Gestisci persone e livelli di accesso in Merchant Center.
5. Configura l'autenticazione con esempi di codice: segui le indicazioni degli esempi di codice ufficiali nella sezione della documentazione Configurazione dell'autenticazione e della configurazione di esempio

Per ulteriori informazioni sull'autorizzazione del service account, consulta Autorizza l'accesso al tuo account Merchant Center e Panoramica dei service account.