Giovedì 10 settembre 2026
Per migliorare l'onboarding degli sviluppatori e l'esperienza di utilizzo, abbiamo creato una nuova home page per l'API Google Ads nella console Google Cloud. Le richieste di accesso di base sono ora automatizzate per gli sviluppatori che hanno completato la verifica del brand. Questo post del blog illustra diverse modifiche correlate che inizieranno a essere implementate oggi. Gli sviluppatori devono esaminare la sezione Azione richiesta di questo post per garantire una transizione senza problemi.
Modifiche alla gestione dell'accesso alle API
Stiamo aggiornando il modo in cui ti registri e gestisci l'accesso all'API Google Ads.
Nuova esperienza di onboarding per l'API Google Ads: ora puoi registrarti per accedere all'API Google Ads direttamente nella console Google Cloud senza bisogno di un account amministratore Google Ads. Stiamo ritirando tutte le nuove funzionalità di registrazione e gestione dell'accesso alle API nella pagina Centro API degli account amministratore e stiamo passando alla pagina Panoramica dell'API Google Ads nella console Google Cloud. Puoi comunque accedere alla pagina Centro API per consultare i dettagli dello sviluppatore precedenti. In futuro questa pagina verrà ritirata completamente.
I livelli di accesso all'API sono associati ai progetti Google Cloud: stiamo ritirando i token sviluppatore. Il livello di accesso del tuo token sviluppatore attuale e attivo viene trasferito automaticamente ai tuoi progetti Google Cloud in base alla recente attività relativa all'API. Puoi continuare a inviare i token sviluppatore nelle intestazioni delle chiamate API, ma questa operazione è facoltativa e i token vengono ignorati dai server API. Il codice esistente continuerà a funzionare senza alcuna modifica. I livelli di accesso all'API sono ora determinati dal progetto Google Cloud che hai utilizzato per generare le credenziali OAuth. Consulta la nostra pagina delle domande frequenti per saperne di più su questa modifica e risolvere eventuali problemi che potresti riscontrare.
Nuovo codice di errore: la versione v25 dell'API Google Ads genererà un errore CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION se provi a utilizzare un progetto cloud Google con livello di accesso all'account di prova per effettuare chiamate a un account di produzione. Le versioni precedenti dell'API genereranno invece un errore ACTION_NOT_PERMITTED. Se riscontri questo errore, vai alla pagina Panoramica dell'API Google Ads del tuo progetto Google Cloud e richiedi l'accesso Explorer.
Modifiche alla procedura di revisione delle API
Verifica del brand richiesta per l'accesso di base e standard: per le nuove richieste di accesso di base e standard, devi completare la verifica del brand per il tuo progetto Google Cloud . I titolari di accesso esistenti non sono tenuti a completare la verifica del brand, anche se è consigliato.
Approvazioni automatiche dell'accesso di base: le richieste di accesso di base sono ora automatizzate e verranno esaminate entro pochi minuti dalla verifica e dall'invio del brand.
Rifiuto una tantum delle richieste di accesso di base in attesa: a causa di questi aggiornamenti della procedura, tutte le richieste di accesso di base all'API in attesa verranno chiuse nell'ambito di questa transizione. I richiedenti interessati riceveranno un'email con i dettagli e dovranno richiedere nuovamente l'accesso all'API dalla pagina Panoramica dell'API Google Ads.
Azione richiesta
Verifica l'accesso all'API: controlla che il livello di accesso all'API del tuo progetto corrisponda correttamente al tuo token sviluppatore esistente:
- Trova il livello di accesso del token sviluppatore nel Centro API dell'account amministratore Google Ads.
- Verifica che il tuo progetto Google Cloud abbia lo stesso livello di accesso nella pagina Panoramica dell'API Google Ads.
- Se i livelli di accesso non corrispondono, richiedi nuovamente l'accesso all'API dalla pagina Panoramica dell'API Google Ads o contatta l'assistenza API Google Ads se hai bisogno di aiuto.
Aggiorna il tuo indirizzo email di contatto per l'API: visita la pagina IAM (Identity and Access Management) del tuo progetto cloud. Assicurati che l'elenco degli utenti con i ruoli di proprietario ed editor sia aggiornato. Inizieremo a inviare annunci di servizio obbligatori a questi indirizzi email per informarti di eventuali modifiche future all'API Google Ads.
Modifiche al codice: ti consigliamo di aggiornare il codice dell'applicazione in modo da non inviare più i token sviluppatore nelle chiamate API. Abbiamo pubblicato nuove versioni delle librerie client che ti consentono di effettuare chiamate API senza impostare un token sviluppatore. Inizieremo a rifiutare i token sviluppatore nelle chiamate API in una versione principale futura dell'API Google Ads.
Se necessario, richiedi nuovamente l'accesso all'API: se la tua richiesta di accesso di base all'API in attesa è stata chiusa nell'ambito di questa transizione, richiedi nuovamente l'accesso all'API dalla pagina Panoramica dell'API Google Ads della console Google Cloud.
Abbiamo pubblicato una documentazione aggiornata per aiutarti a gestire queste modifiche. Per richieste di assistenza tecnica, consulta la nostra pagina delle domande frequenti o contatta l'assistenza per l'API Google Ads. Se hai domande o vuoi discutere di questo post, contattaci sul nostro server Discord della community di Google Advertising and Measurement.
- Anash P. Oommen, team API Google Ads
Etichette: google-ads-api, release