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 di articoli sulla guida introduttiva all'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 a Google. Per configurare l'autenticazione e l'autorizzazione, scegli 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 questo caso, 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, utilizzi un'autorizzazione tramite service account per ottenere l'accesso all'API Merchant. Scegli un'autorizzazione tramite account di servizio 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 da parte di persone: la tua applicazione esegue attività in background , come aggiornamenti automatici dell'inventario o job "cron".
Autorizzazione OAuth 2.0
Se sei un fornitore 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:
- Crea le credenziali OAuth 2.0 in API e servizi in nella console Google Cloud
- Scarica le credenziali client OAuth2 nel file, ad esempio
client-secrets.json - 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 l'articolo Come aggiungere o rimuovere un utente da Merchant Center
- Assegna il ruolo
Adminper eseguire la registrazione. Per saperne di più sui ruoli, consulta Gestire persone e livelli di accesso in Merchant Center - Configura l'autenticazione con gli esempi di codice: segui le indicazioni nella sezione della documentazione Configurazione dell'autenticazione ed esempi di configurazione 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 account di servizio
Utilizza un account di servizio per autorizzare l'accesso all'API Merchant al tuo account Merchant Center. Segui questi passaggi per configurare l'autorizzazione tramite account di servizio per l'API Merchant:
- Crea le credenziali dell'account di servizio in API e servizi nella console Google Cloud
- Scarica la chiave privata: crea e scarica la chiave privata in formato JSON per l'account di servizio. Rinomina il file in
service-account.json - 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 - Assegna l'accesso
Admin. Per saperne di più sui livelli di accesso, consulta l'articolo Gestire persone e livelli di accesso in Merchant Center - Configura l'autenticazione con gli esempi di codice: segui le indicazioni nella sezione della documentazione Configurazione dell'autenticazione ed esempi di configurazione degli esempi di codice ufficiali
Per saperne di più sull'autorizzazione tramite account di servizio, consulta l'articolo Autorizzare l'accesso al tuo account Merchant Center e Panoramica degli account di servizio.