Quando utilizzi l'API Google Ads, gli indirizzi email vengono utilizzati in più posizioni per la gestione dei contatti e degli accessi. I più importanti sono:
- Email di contatto dell'API Google Ads: gli indirizzi email a cui è stato assegnato il ruolo Proprietario o Editor nel tuo progetto Google Cloud, che Google utilizza per inviare annunci di servizio obbligatori e notifiche amministrative.
- Email dell'account della console Google Cloud: l'email che dispone dell'accesso amministrativo al progetto cloud Google utilizzato per l'applicazione OAuth 2.0.
- Accesso all'account amministratore Google Ads: il service account (consigliato) o l'alias email condiviso che dispone delle autorizzazioni di accesso agli account amministratore Google Ads a cui si accede tramite l'API Google Ads.
Il resto di questa guida approfondisce ciascuno degli account elencati in precedenza e spiega come configurarli in modo che l'integrazione non dipenda dall'indirizzo email di un singolo utente.
Email di contatto dell'API Google Ads
Google invia notifiche amministrative, aggiornamenti sulle revisioni delle API, richieste di controllo, annunci di servizio obbligatori (MSA) e comunicazioni di emergenza relative alla produzione agli indirizzi email associati ai ruoli Proprietario ed Editor del tuo progetto Google Cloud (consulta Nuove email di contatto per l'API, poiché l'impostazione precedente dell'email di contatto del Centro API nell'interfaccia utente di Google Ads è stata ritirata).
Per aggiornare l'indirizzo email di contatto e assicurarti che tutto il tuo team riceva queste notifiche, concedi il ruolo Proprietario o Editor a un alias del team condiviso nel tuo progetto Google Cloud e monitora regolarmente le email inviate a quell'alias.
Account della console Google Cloud
Il progetto della console Google Cloud contiene le credenziali OAuth della tua applicazione e controlla l'accesso all'API Google Ads. Assicurati l'accesso a questo progetto concedendo a un alias di team condiviso il ruolo Proprietario (o Editor).
Segui questi passaggi per aggiungere un alias condiviso come proprietario di un progetto Google Cloud:
- Accedi alla console Google Cloud.
- Seleziona il tuo progetto dal selettore di progetti nella parte superiore della pagina.
- Nel menu di navigazione, vai a IAM e amministrazione > IAM.
- Fai clic su Concedi l'accesso.
- Nella sezione Aggiungi entità, inserisci l'indirizzo email condiviso nel campo Nuove entità.
- Nella sezione Assegna i ruoli, fai clic su Seleziona un ruolo e seleziona Base > Proprietario (o Base > Editor).
- Fai clic su Salva. Se hai concesso il ruolo Proprietario a un indirizzo email esterno alla tua organizzazione Google Cloud (o a un progetto senza un'organizzazione), Google Cloud invia un'email di invito all'alias condiviso che deve essere accettata prima che il ruolo diventi effettivo. Consulta la documentazione di Cloud per scoprire di più su come concedere e revocare l'accesso.
account amministratore Google Ads
Un metodo comune per gestire gli account utilizzando l'API Google Ads consiste nel collegare tutti i tuoi account a un account amministratore comune ed effettuare chiamate API a tutti gli account utilizzando le credenziali dell'account amministratore di livello più alto. In questa configurazione, lo sviluppatore imposta l'intestazione della richiesta login-customer-id (o l'impostazione di configurazione della libreria client login_customer_id) sull'ID cliente di 10 cifre (senza trattini) dell'account amministratore Google Ads e imposta il target customer_id sull'account operativo a cui vengono effettuate le chiamate API.
Consigliato: utilizza un service account
L'utilizzo di un service account è l'approccio preferito per l'autenticazione e l'accesso a un account amministratore Google Ads. A differenza degli account utente individuali, un service account viene gestito all'interno del tuo progetto Google Cloud e non è legato a una persona specifica, il che evita interruzioni quando i membri del team cambiano ruolo o lasciano l'azienda. Segui la guida agli account di servizio per creare un account di servizio e concedergli l'accesso al tuo account amministratore Google Ads.
Alternativa: utilizza un alias email condiviso
Se la tua integrazione non può utilizzare un service account e si basa invece sul workflow di autenticazione per un singolo utente, un utente con accesso all'account amministratore Google Ads emette un token di aggiornamento OAuth 2.0.
Per evitare questo scenario quando utilizzi le credenziali utente:
- Invita un alias email condiviso (supportato da un Account Google attivo con la verifica con passkey attivata) a gestire questo account amministratore Google Ads con i livelli di accesso appropriati.
- Accetta l'invito utilizzando l'alias email condiviso.
- Utilizza questo alias email condiviso per emettere il token di aggiornamento OAuth per effettuare chiamate API.