Configurare l'autenticazione per l'API Merchant

Per garantire la sicurezza dei dati, applicare il controllo dell'accesso e mantenere l'integrità del sistema, devi autenticare tutte le richieste dell'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 in sola lettura ai dati di prodotto, mentre altri possono modificare le impostazioni dell'account in Merchant Center.

Questo documento fa parte di una serie in più parti su come iniziare a utilizzare l'API Merchant. Se hai già configurato l'autenticazione con l'API Merchant, puoi passare alla sezione successiva: Registrati come sviluppatore

Autorizzare 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 da utilizzare per altre attività?

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 caso affermativo, utilizzi un'autorizzazione dell'account di servizio per ottenere l'accesso all'API Merchant. Scegli un'autorizzazione del service account se:

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

Autorizzazione OAuth 2.0

Se sei un provider o un'agenzia di terze parti 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 saperne di più, consulta la sezione 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 della sezione della documentazione Configurazione dell'autenticazione e configurazione di esempio degli esempi di codice ufficiali.

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

Autorizzazione tramite service account

Utilizzi un account di servizio per autorizzare l'accesso all'API Merchant al tuo account Merchant Center. Segui questi passaggi per configurare l'autorizzazione dell'account di servizio 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 [e-mail], e aggiungilo come nuovo utente in Merchant Center. Per maggiori dettagli, consulta la sezione Come aggiungere o rimuovere un utente da Merchant Center.
4. Assegnagli l'accesso Admin. Per saperne di più sui livelli di accesso, consulta l'articolo Gestisci persone e livelli di accesso in Merchant Center
5. Configura l'autenticazione con esempi di codice: segui le indicazioni della sezione della documentazione Configurazione dell'autenticazione e configurazione di esempio degli esempi di codice ufficiali.

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