Alias condivisi

Quando si utilizza l'API Google Ads, gli indirizzi email vengono utilizzati per la gestione di contatti e accessi in vari modi, di cui le più importanti sono:

• Email di contatto dell'API Google Ads: è l'indirizzo email indicato come contatto nel Centro API dell'interfaccia utente di Google Ads.
• Indirizzo email dell'account della console Google Cloud: è l'indirizzo email che dispone dell'accesso come amministratore all'account della console Google Cloud utilizzato per la tua applicazione OAuth 2.0.
• Indirizzi email dell'account amministratore Google Ads: sono gli 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, in genere autentichi l'applicazione API Google Ads con uno di questi indirizzi email.

Consigliamo vivamente di utilizzare alias dei team condivisi per non perdere l'accesso a questi account quando i singoli membri del team cambiano team o lasciano l'azienda. Il resto della guida illustra ciascuna delle email elencate in precedenza e spiega come aggiornarla in modo da utilizzare un alias del team condiviso invece dell'indirizzo email di un singolo utente.

Email di contatto dell'API Google Ads

L'indirizzo email di contatto dell'API Google Ads è un indirizzo email che fornisci al momento della registrazione all'API Google Ads. Devi garantire l'accesso a questo alias e monitorare regolarmente le email inviate a questo indirizzo. Google utilizza questo indirizzo email per contattare il tuo team durante revisioni delle API, richieste di controllo o emergenze di produzione che richiedono attenzione immediata. Utilizza un alias del team condiviso come email di contatto per assicurarti che tutto il team riceva queste notifiche.

Per aggiornare l'indirizzo email di contatto per l'API:

• Accedi all'account amministratore Google Ads che hai utilizzato per richiedere l'accesso all'API Google Ads. Si tratta dello stesso account in cui si trova il tuo token sviluppatore.
• Vai a Strumenti e impostazioni > Centro API.
• Fai clic sulla freccia nella sezione Email di contatto per l'API.
• Aggiorna l'indirizzo email e fai clic sul pulsante Salva.

Account Google Cloud Console

Il progetto della console API di Google contiene le credenziali OAuth della tua applicazione e controlla l'accesso all'API Google Ads. Assicurati di accedere 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 a IAM e amministrazione > IAM.
• Fai clic sul pulsante Concedi l'accesso.
• Inserisci l'indirizzo email condiviso nella sezione Aggiungi entità.
• Assegna il ruolo Proprietario.
• Fai clic sul pulsante Salva. Per scoprire di più su come concedere e revocare l'accesso, consulta la documentazione di Cloud.

account amministratore Google Ads

Un metodo comune di gestione degli account utilizzando l'API Google Ads consiste nel collegare tutti gli account in 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 genera 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 rischio potenziale di questa configurazione è che, se l'utente autorizzato perde l'accesso all'account amministratore Google Ads, il token di aggiornamento non sia più valido e tutte le chiamate API non vadano 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.