Alias condivisi

Quando si lavora con l'API Google Ads, gli indirizzi email vengono utilizzati in più posizioni per la gestione di contatti e accessi e le più importanti sono le seguenti:

• Email di contatto per l'API Google Ads: è l'indirizzo email indicato come contatto nel Centro API dell'interfaccia utente di Google Ads.
• Email dell'account Google Cloud Console: l'indirizzo email che ha accesso come amministratore all'account della console Google Cloud utilizzato per la tua applicazione OAuth 2.0.
• 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, in genere autentica l'applicazione dell'API Google Ads con una di queste email.

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

Email di contatto dell'API Google Ads

L'indirizzo email di contatto per l'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 le revisioni delle API, le richieste di controllo o le emergenze di produzione che richiedono un'attenzione immediata. Utilizza un alias del team condiviso come email di contatto per assicurarti che tutto il team riceva queste notifiche.

Per aggiornare l'email di contatto dell'API, segui questi passaggi:

• Accedi all'account amministratore Google Ads che hai utilizzato quando hai richiesto l'accesso all'API Google Ads. Si tratta dello stesso account in cui si trova il token sviluppatore.
• Vai a Strumenti e impostazioni > Centro API.
• Fai clic sulla freccia nella sezione Email di contatto 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 dell'applicazione e controlla l'accesso all'API Google Ads. Assicura l'accesso a questo account impostando un alias condiviso come proprietario dell'account.

Per aggiornare il proprietario del progetto della console API di Google, segui questi passaggi:

• Accedi alla console API di Google.
• Seleziona il tuo progetto dal menu a discesa nell'angolo superiore sinistro 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. 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 mediante l'API Google Ads consiste nel collegare tutti gli 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 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 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.