Per utilizzare l'API Merchant in modo efficace, è importante comprendere i concetti di registrazione, autenticazione e autorizzazione. Hanno scopi diversi per garantire un accesso sicuro e corretto ai dati di Merchant Center.
Terminologia
Registrazione, autenticazione e autorizzazione sono correlate, ma ognuna ha un significato e uno scopo distinti.
- Autenticazione: in questo processo, il servizio verifica l'identità dell'utente o dell'applicazione che effettua una richiesta API. L'API Merchant utilizza meccanismi Google standard come OAuth 2.0. L'utilizzo di chiavi API per l'autenticazione non è supportato e genera errori di autenticazione. Per saperne di più, consulta Autentica le richieste e Autenticati con il tuo account.
- Autorizzazione: questo processo determina quali azioni l'utente o l'applicazione autenticati sono autorizzati a eseguire utilizzando un account Merchant Center. Risponde alla domanda "Cosa puoi fare?" in base ai ruoli e alle autorizzazioni concessi all'utente autenticato nell'account Merchant Center. Ad esempio, un utente potrebbe essere autorizzato a leggere i dati di prodotto, ma non a modificare le impostazioni dell'account.
- Registrazione: per quanto riguarda l'API Merchant, si tratta di una procedura di configurazione una tantum che consente a Google di inviarti importanti annunci di servizio per gli account commerciante che gestisci. La registrazione aggiunge i tuoi indirizzi email di sviluppatore al tuo account Merchant Center principale e lo collega agli ID progetto Google Cloud che utilizzi per l'autenticazione. Questo collegamento consente alla tua applicazione di ricevere annunci di servizio per tutti gli account commerciante che gestisci. Per saperne di più, consulta Crea un progetto Google Cloud.
Registrazione
La procedura di registrazione è fondamentale per consentire alla tua applicazione di utilizzare l'API Merchant. Ecco cosa devi sapere:
Prerequisiti
Per registrarti e utilizzare l'API Merchant, devi:
- Account Merchant Center: devi avere un account Merchant Center esistente.
- Accesso amministrativo: l'Account Google che utilizzi per avviare la chiamata di registrazione deve disporre dei privilegi amministrativi per l'account Merchant Center che stai registrando.
- Progetto Google Cloud: la tua applicazione deve essere associata a un progetto Google Cloud. Questo progetto fornisce le credenziali necessarie (come gli ID client OAuth 2.0) per l'autenticazione della tua applicazione.
Perché non puoi registrare un progetto Google Cloud condiviso
Strumenti come Google OAuth Playground ed Explorer API utilizzano progetti Google Cloud condivisi di proprietà di Google. Non puoi registrarti con progetti condivisi perché:
- Sono destinati ai test e all'esplorazione, non all'identità dell'applicazione di produzione.
- La registrazione implicherebbe un collegamento tra lo strumento condiviso e i tuoi dati specifici di Merchant Center e potrebbe comportare comunicazioni indesiderate.
La tua applicazione deve avere un progetto Google Cloud dedicato, in modo che le comunicazioni relative all'API Merchant che Google ti invia rimangano pertinenti al tuo utilizzo effettivo.
Tuttavia, puoi utilizzare le app web OAuth Playground ed Explorer API per utilizzare l'API Merchant per la sperimentazione e i casi d'uso non di produzione.
Trova l'ID progetto Google Cloud
Puoi trovare l'ID progetto e il numero di progetto nella console Google Cloud. Per maggiori dettagli, consulta Trova il nome, il numero e l'ID del progetto.
Effettua la chiamata di registrazione
Registrati utilizzando il metodo registerGcp all'interno della sotto-API Accounts. Questa chiamata associa il numero del progetto Google Cloud all'account Merchant Center.
Durante la procedura, devi fornire un indirizzo email associato a un singolo utente che utilizzi per chiamare l'API. Questo indirizzo email deve appartenere a un utente con accesso amministrativo all'account Merchant Center.
Informazioni sul campo dell'email
Una comunicazione efficace è fondamentale. Google invia aggiornamenti importanti, annunci di servizio obbligatori, sondaggi per gli sviluppatori e altre opportunità relative all'API Merchant. Una corretta gestione dei contatti garantisce che queste comunicazioni raggiungano le persone giuste.
- Scopo: Google utilizza questo indirizzo email come contatto principale per le comunicazioni relative alle API.
- Di chi è l'email: deve essere l'indirizzo email di un singolo sviluppatore o di un contatto tecnico chiave responsabile dell'integrazione dell'API.
- Best practice:
- SÌ: utilizza l'indirizzo email aziendale di una persona.
- DA EVITARE: l'utilizzo di alias di gruppo generici o email di service account. Le nostre comunicazioni sono destinate a destinatari umani.
La risorsa users per la gestione dei contatti
Sebbene l'indirizzo email nella chiamata di registrazione imposti un contatto iniziale, il modo più efficace per gestire i contatti e le autorizzazioni è utilizzare la risorsa accounts.users dell'API Merchant o le impostazioni di gestione degli utenti nell'interfaccia utente di Merchant Center. Per saperne di più sull'utilizzo di Merchant Center, consulta Gestisci le persone nel tuo account.
Sfrutta queste funzionalità come segue:
- Aggiungi tutti gli sviluppatori: aggiungi gli sviluppatori che lavorano all'integrazione dell'API come utenti dell'account Merchant Center.
- Assegna il ruolo
API_DEVELOPER: oltre ai ruoli standard (Amministratore, Standard), puoi assegnare agli utenti il ruoloAPI_DEVELOPER. In particolare, assegna questo ruolo agli utenti che devono ricevere comunicazioni relative alle API. Puoi combinarlo con altri ruoli. - Vantaggi:
- Separazione chiara: disaccoppia la gestione dei contatti API dalla registrazione una tantum.
- Flessibilità: aggiorna i contatti man mano che i membri del team cambiano.
- Comunicazione mirata: garantisce che le notizie specifiche dell'API vengano inviate alle persone pertinenti.
Anche se hai fornito un indirizzo email durante la registrazione, ti consigliamo vivamente di gestire i contatti API aggiungendo utenti con il ruolo API_DEVELOPER.
Riferimenti
Per ulteriori informazioni, consulta le seguenti risorse: