Token sviluppatore

Il token sviluppatore è una stringa alfanumerica di 22 caratteri utilizzata per connettere la tua 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 del token sviluppatore, abbiamo introdotto diverse modifiche all'esperienza di onboarding dell'API Google Ads e alla gestione dell'accesso all'API. Questa sezione mette in evidenza le modifiche principali.

I livelli di accesso API sono associati ai progetti Google Cloud

I token sviluppatore verranno ritirati il 9 settembre 2026. Il tuo 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 token dello 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 tuoi 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 o 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, ad esempio la richiesta di accesso all'API e la gestione dei livelli di accesso all'API nella pagina Centro API negli account amministratore Google Ads. Queste funzionalità sono ora disponibili nella pagina Panoramica dell'API Google Ads in Google Cloud Console.

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

Nuovi codici di errore

La versione v25 dell'API Google Ads genererà un errore CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION se provi a utilizzare un progetto Google Cloud con accesso di test per effettuare chiamate a un account di produzione. Le versioni precedenti dell'API genereranno un errore ACTION_NOT_PERMITTED. Se si verifica 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 con 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 è consigliata.

Le richieste di accesso di base ora sono automatizzate e verranno esaminate entro pochi minuti dopo la verifica e l'invio del brand.

A causa di questi aggiornamenti della procedura, tutte le richieste di accesso 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 di base dalla pagina Panoramica dell'API Google Ads.

Nuovi indirizzi email di contatto per l'API

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

Cosa fare se sei uno sviluppatore esistente

Controlla i livelli di accesso 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 API del tuo token sviluppatore esistente. Segui le istruzioni in questa guida per risolvere eventuali discrepanze.

Controlla l'indirizzo email di contatto API: visita la pagina IAM (Identity and Access Management) per il tuo progetto Google Cloud. Verifica che gli sviluppatori e i responsabili account Google Ads attivi abbiano i ruoli di proprietario o editor appropriati nel tuo progetto Google Cloud. Inizieremo a inviare annunci di servizio obbligatori a questi indirizzi email per informarti di eventuali modifiche future all'API Google Ads. Continueremo a inviare MSA all'indirizzo email di contatto indicato nel tuo Centro API per un periodo temporaneo 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 nell'ambito delle chiamate API. Abbiamo pubblicato versioni aggiornate delle librerie client, del server MCP di Google Ads e dell'assistente per gli sviluppatori dell'API Google Ads, che ti consentono di effettuare chiamate API senza impostare un token sviluppatore. In una futura versione principale dell'API Google Ads inizieremo a rifiutare i token sviluppatore nelle chiamate API. Se la tua app utilizza queste librerie, aggiorna le dipendenze dell'app per utilizzare l'ultima versione.

Contatta l'assistenza 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 API vengono ancora applicati nell'API Google Ads. Tuttavia, ora vengono concessi al tuo progetto console Google Cloud anziché al tuo token sviluppatore. Quando effettui chiamate API, i tuoi livelli di accesso 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 API?

Se avevi già un token sviluppatore approvato prima del 9 settembre 2026, i suoi 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 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 alle 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 di avere 4 token sviluppatore e 6 progetti Cloud con i seguenti dettagli:

  • Token sviluppatore 1: abcdefghijkl1234567890 ha accesso standard. È stato utilizzato con gli ID progetto: 1234567890, 5678912345, 45678912345.
  • Token sviluppatore 2: xyzabcdefghi6789012345 ha accesso di base. È stato utilizzato con gli ID progetto: 1231235678.
  • Token sviluppatore 3: asdfgflkjhjz7654321012 ha accesso di base, ma non è mai stato utilizzato per effettuare una chiamata API. È stato approvato di recente.
  • Token sviluppatore 4: qwertypoiuyu6543298790 aveva accesso standard, ma non è stato utilizzato negli ultimi 90 giorni. L'ID progetto 9876564900 è stato utilizzato in passato con questo token sviluppatore.
  • 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 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 API del token sviluppatore non è stato trasferito a nessun progetto perché non è mai stato utilizzato per effettuare una chiamata API.
qwertypoiuyu6543298790 9876564900 Controlla l'accesso L'accesso API del token sviluppatore è stato revocato a causa di inattività per 90 giorni. Il livello di accesso API del progetto è impostato per impostazione predefinita su Accesso di test.
-- 7171234567 Controlla l'accesso Si tratta di un nuovo progetto che non è stato utilizzato con alcun token sviluppatore. Il livello di accesso API del progetto è impostato per impostazione predefinita su Accesso di test.

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

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

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

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

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

Se l'accesso all'API Google Ads è assegnato a un progetto Google Cloud che non utilizzi più, non sono necessarie ulteriori azioni da parte tua. Google revoca l'accesso all'API per il progetto inutilizzato dopo 90 giorni di inattività.

I livelli di accesso API non sono stati assegnati al mio progetto Google Cloud. Come faccio a risolvere il 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 API del token sviluppatore è scaduto di recente a causa dell'inattività. Per risolvere il problema, richiedi il livello di accesso API appropriato per il progetto dalla pagina Panoramica dell'API Google Ads. Vedi un esempio.

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

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

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

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

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

Tutte le richieste di accesso di base in attesa che hai avviato 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 che hai avviato dal Centro API del tuo account amministratore Google Ads a partire dal 9 settembre 2026 verranno esaminate come di consueto. Se approvato, al progetto cloud 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 il ripristino dell'associazione di un token sviluppatore a un nuovo progetto Google Cloud caso per caso. Questa funzionalità non è più supportata a partire dal 9 settembre 2026, in quanto abbiamo ritirato i token sviluppatore. Se devi utilizzare un nuovo progetto Google Cloud, devi richiedere l'accesso 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 API se non viene utilizzato per 90 giorni consecutivi. Se non utilizzi il token sviluppatore da un po' di tempo, è probabile che i suoi livelli di accesso siano stati revocati a causa di inattività. In questo caso, richiedi nuovamente l'accesso all'API per il tuo progetto cloud Google dalla pagina Panoramica dell'API Google Ads. Vedi un esempio.

  2. Il tuo 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 suoi livelli di accesso non sono stati trasferiti al progetto Cloud. Di conseguenza, non puoi più utilizzare il tuo token dello 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 API appropriato dalla pagina Panoramica dell'API Google Ads del tuo progetto Google Cloud. Vedi un esempio.

In entrambi i casi, puoi richiedere l'accesso Explorer e l'accesso di livello base e ottenere la revisione automatica. Non è più necessario collaborare con il team di conformità di Google per completare la procedura di revisione. Se hai bisogno dell'accesso standard, devi richiedere 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 di token sviluppatore nell'ambito delle mie richieste API?

Sì, puoi interrompere l'invio di token sviluppatore nell'ambito delle richieste API. Se utilizzi una libreria client, potresti dover eseguire l'upgrade all'ultima versione. Controlla i log delle modifiche della libreria per verificare se supporta l'esecuzione di chiamate API senza specificare un token sviluppatore.

Ho partecipato al programma pilota del livello di accesso gestito da Cloud. In che modo mi riguarda?

Il programma pilota per il livello di accesso gestito dal cloud è stato introdotto per consentire agli sviluppatori Google Cloud di effettuare chiamate API senza inviare un token sviluppatore nell'ambito della 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 progetto Google Cloud.

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

Google potrebbe eseguire programmi pilota che danno ad alcuni sviluppatori l'accesso a funzionalità sperimentali. L'accesso a queste funzionalità a volte viene fornito aggiungendo il token sviluppatore a una lista consentita. Se hai partecipato a un programma pilota di questo tipo, non è richiesta alcuna azione da parte tua.

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

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 token sviluppatore approvato. Poiché non hai mai utilizzato il tuo token sviluppatore approvato con il nuovo progetto Google Cloud prima del 9 settembre 2026, i suoi livelli di accesso non sono stati trasferiti al progetto Cloud. Se tenti di effettuare una chiamata API con questo token sviluppatore, verrà generato un errore CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION, poiché i token sviluppatore non vengono più utilizzati per determinare i livelli di accesso all'API. Per risolvere l'errore, richiedi l'accesso API appropriato dalla pagina Panoramica dell'API Google Ads del tuo progetto Google Cloud. Vedi 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 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.

Che cosa succede all'API Center?

La pagina esistente del Centro API 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 dati vengono forniti solo a scopo di riferimento. Non eseguire attività correlate ai livelli di accesso del token sviluppatore, ad esempio la richiesta di livelli di accesso API superiori da questa pagina.

Se devi richiedere livelli di accesso 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 è più necessario un account amministratore Google Ads per utilizzare l'API Google Ads. Hai bisogno di un account amministratore solo se devi collegarti a più account e gestirli 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 ottenere un token sviluppatore dal Centro API del tuo account amministratore Google Ads, queste richieste non verranno elaborate. L'API Center verrà ritirato a breve.

Avanti
Livelli di accesso e utilizzo consentito