Alias condivisi

Quando utilizzi l'API Google Ads, gli indirizzi email vengono utilizzati in più punti per la gestione dei contatti e dell'accesso. I più importanti sono i seguenti:

• Indirizzo email di contatto dell'API Google Ads: si tratta dell'indirizzo email indicato come contatto nel Centro API dell'interfaccia utente di Google Ads.
• Indirizzo email dell'account della console Google Cloud: si tratta dell'indirizzo email che ha accesso amministrativo all'account della console Google Cloud utilizzato per la tua applicazione OAuth 2.0.
• Indirizzi email dell'account amministratore Google Ads: si tratta degli indirizzi email che dispongono delle autorizzazioni di amministratore per gli account amministratore Google Ads a cui accedi tramite l'API Google Ads. Quando generi un token di aggiornamento per la tua applicazione, solitamente autentichi l'applicazione API Google Ads con una di queste email.

Ti consigliamo vivamente di utilizzare gli alias di gruppo condivisi per non perdere l'accesso a questi account quando i singoli membri del team cambiano team o lasciano l'azienda. Il resto di questa guida illustra ciascuna delle email elencate in precedenza e come puoi aggiornarla per utilizzare un alias di gruppo condiviso anziché l'indirizzo email di un singolo utente.

Indirizzo email di contatto dell'API Google Ads

L'indirizzo email di contatto dell'API Google Ads è l'indirizzo che fornisci quando ti registri per l'API Google Ads. Devi assicurarti di avere accesso a questo alias e monitorare regolarmente le email inviate a questo indirizzo. Google utilizza questo indirizzo email per contattare il tuo team durante le revisioni dell'API, le richieste di controllo o le emergenze di produzione che richiedono attenzione immediata. Utilizza un alias di gruppo condiviso come indirizzo email di contatto per assicurarti che tutto il team riceva queste notifiche.

Per aggiornare l'email di contatto dell'API:

1. Accedi all'account amministratore Google Ads.

2. Fai clic su Amministrazione in basso a sinistra nella schermata.

3. In Impostazioni account amministratore, fai clic su Centro API.

4. In Dettagli sviluppatore, prendi nota dell'indirizzo email di contatto dell'API. Fai clic sulla Freccia giù e modifica l'email. Fai clic su Salva.

Account della console Google Cloud

Il progetto della console API di Google contiene le credenziali OAuth della tua applicazione e controlla l'accesso all'API Google Ads. Assicurati l'accesso a questo account impostando un alias condiviso come proprietario dell'account.

Per aggiornare il proprietario del progetto della console API di Google:

• Accedi alla console API di Google.
• Seleziona il tuo progetto dal menu a discesa nell'angolo in alto a sinistra della pagina.
• Nel menu a sinistra, vai ad IAM e amministrazione > IAM.
• Fai clic sul pulsante Concedi accesso.
• Inserisci l'indirizzo email condiviso nella sezione Aggiungi principali.
• Assegna il ruolo Proprietario.
• Fai clic sul pulsante Salva. Per saperne di più su come concedere e revocare l'accesso, consulta la documentazione di Cloud.

account amministratore Google Ads

Un metodo comune per gestire gli account utilizzando l'API Google Ads è collegare tutti gli account a un account amministratore comune ed eseguire chiamate API a tutti gli account utilizzando le credenziali dell'account amministratore principale. In questa configurazione:

• Lo sviluppatore emette un token di aggiornamento utilizzando le credenziali di un utente che ha accesso all'account amministratore Google Ads.
• Lo sviluppatore imposta l'intestazione login_customer_id come ID cliente dell'account amministratore Google Ads e l'intestazione customer_id come ID cliente dell'account a cui vengono effettuate le chiamate API.

Un potenziale rischio di questa configurazione è che, se l'utente autorizzato perde l'accesso all'account amministratore Google Ads, il token di aggiornamento non è più valido e tutte le chiamate all'API non vanno a buon fine. Per evitare questo scenario, puoi invitare un alias email condiviso a gestire questo account amministratore Google Ads con i livelli di accesso appropriati. Utilizza questo alias email condiviso per emettere il token di aggiornamento per effettuare chiamate API.