Token sviluppatore

Il token sviluppatore è una stringa alfanumerica di 22 caratteri che veniva utilizzata per collegare l'app all'API Google Ads. I token sviluppatore sono stati ritirati il 9 settembre 2026. Questa guida riassume le modifiche ed elenca le domande frequenti su questa migrazione per aiutare gli sviluppatori esistenti.

Cosa cambierà?

Nell'ambito del ritiro dei token sviluppatore, abbiamo introdotto diverse modifiche all'esperienza di onboarding dell'API Google Ads e alla gestione dell'accesso all'API. Questa sezione evidenzia le modifiche principali.

I livelli di accesso all'API sono associati ai progetti Google Cloud

Abbiamo ritirato i token sviluppatore il 9 settembre 2026. Il livello di accesso al token sviluppatore attuale e attivo è stato trasferito automaticamente ai tuoi progetti Google Cloud in base all'attività API recente. Puoi continuare a inviare i token sviluppatore nelle intestazioni delle chiamate API, ma questa operazione è facoltativa e viene ignorata dai server API. Il codice esistente continuerà a funzionare senza modifiche. I livelli di accesso all'API sono ora determinati dal progetto Google Cloud che hai utilizzato per generare le credenziali OAuth.

Una nuova esperienza di registrazione per l'API Google Ads

Ora puoi registrarti per accedere all'API Google Ads direttamente nella console Google Cloud senza richiedere un account amministratore Google Ads. Non registrarti per un token sviluppatore dalla pagina del Centro API e non tentare di richiedere l'accesso all'API dalla pagina del Centro API nel tuo account amministratore Google Ads , poiché queste procedure sono state trasferite alla console Google Cloud e non verranno elaborate se avviate dalla pagina del Centro API.

Una nuova esperienza di gestione dell'accesso all'API

Abbiamo ritirato tutte le nuove funzionalità di registrazione e gestione dell'accesso all'API, come la richiesta di accesso all'API e la gestione dei livelli di accesso all'API nella pagina del Centro API negli account amministratore Google Ads. Queste funzionalità sono ora disponibili nella pagina Panoramica dell'API Google Ads nella console Google Cloud.

Puoi comunque accedere alla pagina del Centro API per consultare i tuoi dettagli storici dello sviluppatore. Questa pagina verrà ritirata completamente in futuro.

Nuovi codici di errore

La versione v25 dell'API Google Ads genererà un CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION se tenti di utilizzare un progetto Google Cloud con il livello di accesso all'account di prova per effettuare chiamate a un account di produzione. Le versioni precedenti dell'API genereranno invece un ACTION_NOT_PERMITTED. Se riscontri questo errore, vai alla pagina Panoramica dell'API Google Ads per il tuo progetto Google Cloud e richiedi l'accesso Explorer.

La verifica del brand è obbligatoria per l'accesso di base e standard

Per le nuove applicazioni di accesso di base e standard, devi completare la verifica del brand per il tuo progetto Google Cloud. I titolari dell'accesso esistenti non sono tenuti a completare la verifica del brand, anche se è consigliabile.

Le applicazioni di accesso di base sono ora automatizzate e verranno esaminate entro pochi minuti dalla verifica e dall'invio del brand.

A causa di questi aggiornamenti della procedura, tutte le applicazioni di accesso API di base 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.

Nuovi indirizzi email di contatto per l'API

In preparazione al ritiro della pagina del Centro API, passeremo a utilizzare l'elenco degli utenti proprietari ed editor nel tuo progetto Google Cloud come unico canale per le comunicazioni amministrative e di conformità obbligatorie. Per garantire una transizione senza problemi, continueremo temporaneamente a inviare gli annunci di servizio obbligatori all'indirizzo email indicato nel Centro API. Ti terremo aggiornato man mano che finalizzeremo la transizione dei nostri canali di comunicazione.

Cosa fare se sei uno sviluppatore esistente

Esamina i livelli di accesso all'API del tuo progetto Google Cloud: se sei uno sviluppatore esistente, ti invitiamo a esaminare la pagina Panoramica dell'API Google Ads dei tuoi progetti Google Cloud per assicurarti che abbiano lo stesso livello di accesso all'API del tuo token sviluppatore esistente. Segui le istruzioni riportate in questa guida per risolvere eventuali discrepanze.

Esamina l'indirizzo email di contatto per l'API: visita la pagina IAM (Identity and Access Management) del tuo progetto Google Cloud. Verifica che agli sviluppatori e agli account manager di Google Ads attivi siano assegnati i ruoli di proprietario o editor appropriati nel tuo progetto Google Cloud. Inizieremo a inviare gli annunci di servizio obbligatori a questi indirizzi email per informarti di eventuali modifiche future all'API Google Ads. Continueremo a inviare gli annunci di servizio obbligatori all'indirizzo email di contatto indicato nel Centro API per un periodo di tempo limitato e ti informeremo ogni volta che questa procedura verrà aggiornata.

Correggi il codice dell'app: ti consigliamo di aggiornare l'app per interrompere l'invio del token sviluppatore come parte delle chiamate API. Abbiamo pubblicato versioni aggiornate di delle librerie client, del server MCP Google Ads e dell'assistente per sviluppatori dell'API Google Ads che ti consentono di effettuare chiamate API senza impostare un token sviluppatore. Inizieremo a rifiutare i token sviluppatore nelle chiamate API in una futura versione principale dell'API Google Ads. Se la tua app utilizza queste librerie, aggiorna le dipendenze dell'app per utilizzare la versione più recente.

Contatta l'assistenza dell'API Google Ads se hai bisogno di ulteriore aiuto o hai altre domande.

Domande frequenti

Che cosa succede ai livelli di accesso all'API?

I livelli di accesso all'API vengono ancora applicati nell'API Google Ads. Tuttavia, ora vengono concessi al progetto della console Google Cloud anziché al token sviluppatore. Quando effettui chiamate API, i livelli di accesso all'API sono ora determinati dal progetto Google Cloud che hai utilizzato per generare le credenziali OAuth.

Come sono stati identificati i progetti per il trasferimento dei livelli di accesso all'API?

Se avevi già un token sviluppatore approvato prima del 9 settembre 2026, i relativi livelli di accesso sono stati trasferiti ai tuoi progetti Google Cloud nel seguente modo:

  • Abbiamo esaminato i log delle chiamate API degli ultimi 90 giorni per identificare i progetti Cloud utilizzati per effettuare chiamate API con il tuo token sviluppatore approvato.
  • Abbiamo assegnato i livelli di accesso all'API del token sviluppatore a tutti i progetti Cloud identificati.

Posso avere più progetti Cloud con vari livelli di accesso dopo questa modifica?

Sì, puoi avere più progetti Google Cloud con diversi livelli di accesso all'API. Ad esempio, puoi avere un progetto Google Cloud con accesso di base e un altro progetto Google Cloud con accesso standard.

Esempio

Ad esempio, supponiamo che tu abbia 4 token sviluppatore e 6 progetti Cloud con i seguenti dettagli:

  • Il token sviluppatore 1: abcdefghijkl1234567890 ha l'accesso standard. È stato utilizzato con gli ID progetto: 1234567890, 5678912345, 45678912345.
  • Il token sviluppatore 2: xyzabcdefghi6789012345 ha l'accesso di base. È stato utilizzato con gli ID progetto: 1231235678.
  • Il token sviluppatore 3: asdfgflkjhjz7654321012 ha l'accesso di base, ma non è mai stato utilizzato per effettuare una chiamata API. È stato approvato di recente.
  • Il token sviluppatore 4: qwertypoiuyu6543298790 aveva l'accesso standard, ma non è stato utilizzato negli ultimi 90 giorni. L'ID progetto 9876564900 è stato utilizzato con questo token sviluppatore in passato.
  • Progetto Cloud: l'ID progetto Cloud: 7171234567 non è mai stato utilizzato con nessuno dei token sviluppatore per effettuare una chiamata API.

I livelli di accesso all'API verranno trasferiti dai token sviluppatore ai progetti Google Cloud nel seguente modo:

Token sviluppatore ID progetto Livello di accesso Spiegazione
abcdefghijkl1234567890 1234567890 Accesso standard Il token sviluppatore e l'ID progetto sono associati tra loro.
abcdefghijkl1234567890 5678912345 Accesso standard Il token sviluppatore e l'ID progetto sono associati tra loro.
abcdefghijkl1234567890 45678912345 Accesso standard Il token sviluppatore e l'ID progetto sono associati tra loro.
xyzabcdefghi6789012345 1231235678 Accesso di base Il token sviluppatore e l'ID progetto sono associati tra loro.
asdfgflkjhjz7654321012 -- -- L'accesso all'API del token sviluppatore non è stato trasferito a nessun progetto perché non è mai stato utilizzato per effettuare una chiamata API.
qwertypoiuyu6543298790 9876564900 Accesso all'account di prova L'accesso all'API del token sviluppatore è stato revocato a causa dell'inattività per 90 giorni. Il livello di accesso all'API del progetto è impostato per impostazione predefinita sull'accesso all'account di prova.
-- 7171234567 Accesso all'account di prova Si tratta di un nuovo progetto che non è stato utilizzato con nessun token sviluppatore. Il livello di accesso all'API del progetto è impostato per impostazione predefinita sull'accesso all'account di prova.

Ho più di un token sviluppatore approvato. A quale progetto trasferirete i livelli di accesso all'API?

I livelli di accesso di ogni token sviluppatore approvato verranno trasferiti ai progetti Google Cloud associati a quel token sviluppatore. Guarda un esempio.

Utilizzo più progetti Google Cloud. A quale progetto trasferirete i livelli di accesso all'API?

Se hai utilizzato più progetti Google Cloud con il tuo token sviluppatore approvato negli ultimi 90 giorni, tutti questi progetti riceveranno gli stessi livelli di accesso all'API del tuo token sviluppatore. Guarda un esempio.

I livelli di accesso all'API sono stati assegnati a un progetto che non utilizzo più. Come faccio a risolvere questo problema?

Se l'accesso all'API Google Ads viene assegnato a un progetto Google Cloud che non utilizzi più, non è necessario alcun intervento da parte tua. Google revocherà l'accesso all'API per il progetto inutilizzato dopo 90 giorni di inattività.

I livelli di accesso all'API non sono stati assegnati al mio progetto Google Cloud. Come faccio a risolvere questo problema?

Il tuo progetto Google Cloud non ha ereditato il livello di accesso del token sviluppatore, probabilmente perché non hai mai utilizzato il token sviluppatore e il progetto Cloud per effettuare una chiamata API oppure l'accesso all'API del token sviluppatore è scaduto di recente a causa dell'inattività. Per risolvere il problema, richiedi il livello di accesso all'API appropriato per il progetto dalla pagina Panoramica dell'API Google Ads. Guarda un esempio.

Dove posso vedere i livelli di accesso all'API del mio progetto?

Puoi visualizzare il livello di accesso all'API del tuo progetto Google Cloud dalla pagina Panoramica dell'API Google Ads.

Come faccio a richiedere livelli di accesso all'API più elevati?

Puoi richiedere livelli di accesso all'API più elevati per il tuo progetto Google Cloud dalla pagina Panoramica dell'API Google Ads.

Che cosa succede alla mia richiesta di accesso all'API in attesa?

Tutte le richieste di accesso di base in attesa avviate dal Centro API del tuo account amministratore Google Ads prima del 9 settembre 2026 verranno chiuse. Devi richiedere nuovamente l'accesso di base dalla pagina Panoramica dell'API Google Ads del tuo progetto Google Cloud. Se questa modifica ti riguarda, riceverai un'email con le istruzioni necessarie.

Tutte le richieste di accesso standard in attesa avviate dal Centro API del tuo account amministratore Google Ads a partire dal 9 settembre 2026 verranno esaminate come di consueto. Se approvato, al progetto Google Cloud associato al tuo token sviluppatore verrà concesso l'accesso standard.

Posso riassociare il mio token sviluppatore approvato a un nuovo progetto Google Cloud?

In passato, il team dell'API Google Ads supportava la riassociazione di un token sviluppatore a un nuovo progetto Google Cloud caso per caso. Questa funzionalità non è più supportata a partire dal 9 settembre 2026, poiché abbiamo ritirato i token sviluppatore. Se devi utilizzare un nuovo progetto Google Cloud, devi richiedere l'accesso all'API appropriato dalla pagina Panoramica dell'API Google Ads del tuo progetto Google Cloud.

Ho un token sviluppatore approvato, ma non l'ho mai utilizzato. Posso utilizzare questo token sviluppatore?

No, non puoi utilizzare questo token sviluppatore. Esistono due possibilità:

  1. L'accesso al token sviluppatore potrebbe essere revocato per inattività: in base alle norme di Google, Google può revocare il token dell'API se non viene utilizzato per 90 giorni consecutivi. Se non hai utilizzato il token sviluppatore da un po' di tempo, è probabile che i relativi livelli di accesso siano stati revocati a causa dell'inattività. In questo caso, richiedi nuovamente l'accesso all'API per il tuo progetto Google Cloud dalla pagina Panoramica dell'API Google Ads. Guarda un esempio.

  2. Il token sviluppatore è stato approvato di recente, ma non l'hai mai utilizzato prima del 9 settembre 2026: poiché non hai mai utilizzato il token sviluppatore approvato con un progetto Google Cloud prima del 9 settembre 2026, i relativi livelli di accesso non sono stati trasferiti al progetto Cloud. Di conseguenza, non puoi più utilizzare il token sviluppatore. Se tenti di effettuare una chiamata API a un account di produzione con questo token sviluppatore, verrà generato un errore CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION. Per correggere l'errore, richiedi l'accesso all'API appropriato dalla pagina Panoramica dell'API Google Ads del tuo progetto Google Cloud. Guarda un esempio.

In entrambi i casi, puoi richiedere l'accesso Explorer e i livelli di accesso di base e farli esaminare automaticamente; non devi più collaborare con il team di conformità di Google per completare la procedura di revisione. Se hai bisogno dell'accesso standard, è necessaria una revisione manuale. Tuttavia, puoi condividere i dettagli del token sviluppatore approvato quando richiedi l'accesso standard, in modo che il team di conformità possa esaminare la tua nuova richiesta di accesso standard di conseguenza.

Posso interrompere l'invio dei token sviluppatore come parte delle mie richieste API?

Sì, puoi interrompere l'invio dei token sviluppatore come parte delle tue richieste API. Se utilizzi una libreria client, potresti dover eseguire l'upgrade alla versione più recente. Controlla i log delle modifiche della libreria per verificare se supporta l'esecuzione di chiamate API senza specificare un token sviluppatore.

Facevo parte del programma pilota del livello di accesso gestito dal cloud. In che modo mi riguarda?

Il programma pilota del livello di accesso gestito dal cloud è stato introdotto per consentire agli sviluppatori di Google Cloud di effettuare chiamate API senza inviare un token sviluppatore come parte del la richiesta API. Ora che abbiamo ritirato i token sviluppatore, questo programma verrà interrotto.

I livelli di accesso del tuo token sviluppatore attivo sono stati trasferiti al tuo progetto Google Cloud, quindi il codice esistente dovrebbe continuare a funzionare senza modifiche. Se devi utilizzare un nuovo progetto Google Cloud, devi richiedere l'accesso all'API dalla pagina Panoramica dell'API Google Ads del tuo progetto Google Cloud.

Il mio token sviluppatore faceva parte di una lista consentita. In che modo mi riguarda?

Google può eseguire programmi pilota che consentono ad alcuni sviluppatori di accedere a funzionalità sperimentali. L'accesso a queste funzionalità viene talvolta fornito aggiungendo il token sviluppatore a una lista consentita. Se facevi parte di un programma pilota di questo tipo, non è necessario alcun intervento da parte tua.

Abbiamo aggiornato tutti i programmi pilota in modo che utilizzino i progetti Google Cloud anziché i token sviluppatore come meccanismo di lista consentita e abbiamo trasferito lo stato della lista consentita del token sviluppatore ai progetti Google Cloud associati. Il codice esistente dovrebbe continuare a funzionare senza modifiche. Se continui a riscontrare problemi, contatta il tuo account manager Google che ti ha registrato al programma pilota.

Ho un token sviluppatore approvato e voglio utilizzarlo con un nuovo progetto Google Cloud. È consentito?

No, non puoi utilizzare un nuovo progetto cloud Google con il tuo token sviluppatore approvato. Poiché non hai mai utilizzato il token sviluppatore approvato con il nuovo progetto Google Cloud prima del 9 settembre 2026, i relativi livelli di accesso non sono stati trasferiti al progetto Cloud. Se tenti di effettuare una chiamata API con questo token sviluppatore, verrà generato un CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION errore, poiché i token sviluppatore non vengono più utilizzati per determinare i livelli di accesso all'API. Per correggere l'errore, richiedi l'accesso all'API appropriato dalla pagina Panoramica dell'API Google Ads del tuo progetto Google Cloud. Guarda un esempio.

Il mio token sviluppatore è stato divulgato esternamente. Devo reimpostare il mio token sviluppatore?

No, in questo caso non è necessario reimpostare il token sviluppatore. Poiché abbiamo trasferito i livelli di accesso all'API del tuo token sviluppatore al tuo progetto Google Cloud, un utente non autorizzato non può più utilizzare il tuo token sviluppatore con il proprio progetto Google Cloud. Tuttavia, puoi reimpostare il token sviluppatore dal Centro API, se preferisci.

Che cosa succede al Centro API?

La pagina del Centro API esistente all'interno dell'account amministratore Google Ads è deprecata e verrà rimossa a breve. Se hai già un token sviluppatore, puoi comunque accedere al tuo account amministratore Google Ads e visualizzare i dettagli. Tuttavia, questi dettagli vengono forniti solo a scopo di riferimento. Non eseguire attività correlate ai livelli di accesso al token sviluppatore, ad esempio la richiesta di livelli di accesso all'API più elevati da questa pagina.

Se devi richiedere livelli di accesso all'API più elevati, devi farlo dalla pagina Panoramica dell'API Google Ads del tuo progetto Google Cloud.

Ho ancora bisogno di un account amministratore Google Ads per utilizzare l'API Google Ads?

Non hai più bisogno di un account amministratore Google Ads per utilizzare l'API Google Ads. Hai bisogno di un account amministratore solo se devi collegare e gestire più account utilizzando l'API.

Sono un nuovo sviluppatore. Come faccio a registrarmi all'API Google Ads?

Segui le istruzioni riportate nella Guida introduttiva per registrarti all'API Google Ads. Non registrarti per un token sviluppatore dal Centro API del tuo account amministratore Google Ads; queste richieste non verranno elaborate. Il Centro API verrà ritirato a breve.

Avanti
Livelli di accesso e utilizzo consentito