Il token sviluppatore è una stringa alfanumerica di 22 caratteri che consente alla tua app di connettersi all'API Google Ads. Puoi ottenerne uno registrandoti nella pagina Centro API del tuo account amministratore Google Ads. Ogni volta che effettui una chiamata API, invii il token sviluppatore come parte della richiesta impostando l'intestazione HTTP o gRPC developer-token.
A ogni token sviluppatore viene assegnato un livello di accesso che controlla il numero di chiamate API che puoi effettuare al giorno con il token, nonché l' ambiente a cui puoi effettuare le chiamate.
Quando ti registri per un token sviluppatore, per impostazione predefinita ti potrebbe essere concesso il livello di accesso Explorer. In questo modo, puoi effettuare chiamate agli account di produzione, ma con alcune limitazioni. In alcuni casi in cui non siamo in grado di esaminare automaticamente la tua richiesta di token sviluppatore, potremmo concedere al tuo token sviluppatore un livello di accesso all'account di test. In questo modo, puoi effettuare chiamate API solo agli account di test. Per rimuovere le limitazioni dei livelli di accesso Explorer e all'account di test, devi richiedere il livello di accesso di base o accesso standard per il tuo token sviluppatore. Una volta esaminata e approvata la richiesta di token sviluppatore, al token sviluppatore verrà concesso il livello di accesso appropriato.
Hai bisogno di un nuovo token sviluppatore?
Se devi registrarti per un nuovo token sviluppatore o meno dipende da alcuni fattori. Di seguito sono riportati alcuni scenari comuni:
Scenario |
Passaggi successivi |
| La tua azienda non ha mai utilizzato l'API Google Ads e vuoi sviluppare le tue app | Registrati per un nuovo token sviluppatore. Scopri di più |
| La tua azienda utilizza o ha utilizzato l'API Google Ads in passato | In genere, Google concede un token sviluppatore per azienda, quindi se la tua azienda utilizza già l'API Google Ads, devi riutilizzare il token sviluppatore esistente token. Scopri di più |
| La tua azienda utilizza già l'API Google Ads, ma sta anche sviluppando un nuovo prodotto o strumento | Se sei certo di non poter utilizzare il token sviluppatore esistente, allora puoi richiederne uno nuovo spiegando il tuo caso d'uso nella richiesta. Per il resto di questa guida, puoi utilizzare il token sviluppatore esistente. Scopri di più |
| La tua azienda utilizza un'app di terze parti | Hai bisogno di un token sviluppatore solo se stai sviluppando la tua app. Se utilizzi un'app o un servizio di terze parti, lo sviluppatore dell'app deve ottenere un token sviluppatore per l'app. Se non hai chiarezza sul tuo caso, contatta il team di conformità dell'API. |
Chi può richiedere un token sviluppatore?
Sia le aziende che i singoli sviluppatori possono richiedere un token sviluppatore. La tabella seguente riassume i dettagli che devi fornire quando ti registri per il token sviluppatore.
| Se sei | Fornisci i seguenti dettagli dello sviluppatore | Note aggiuntive |
|---|---|---|
| Uno sviluppatore che rappresenta la tua azienda o un team di prodotto | Il nome dell'azienda e l'URL dell'azienda | In genere, Google concede un token sviluppatore per azienda, ma approva token sviluppatori separati per strumenti separati caso per caso. |
| Un singolo sviluppatore che non rappresenta un'azienda | Specifica il nome dell'azienda come Individual. Puoi
fornire URL alternativi, ad esempio l'URL del tuo profilo GitHub o l'URL del tuo profilo LinkedIn,
anziché l'URL di un'azienda. |
Devi avere una presenza online e fornire a Google un URL
che ci aiuti a valutare cosa intendi fare con l'API Google Ads. Gli URL generici
come test.com ed example.com non sono
accettati. |
Come richiedere un token sviluppatore
La richiesta di un token sviluppatore prevede due passaggi.
Passaggio 1: seleziona o crea un account amministratore Google Ads
Se hai già un account amministratore Google Ads, selezionalo quando richiedi il token sviluppatore. Se questo account amministratore non è già collegato agli altri account, ti consigliamo di inserirlo alla radice della gerarchia di account per semplificare la procedura di revisione del token e la gestione degli account in un secondo momento.
Se non hai un account amministratore, puoi seguire le istruzioni del Centro assistenza per crearne uno.
Passaggio 2: richiedi l'accesso all'API Google Ads
Tieni presente che la procedura di revisione del token sviluppatore può richiedere del tempo. Scopri di più.
Vai all'indirizzo https://ads.google.com/aw/apicenter nel browser web. Se richiesto, accedi al tuo account amministratore Google Ads.
Compila il modulo di accesso all'API e accetta i Termini e condizioni.
Assicurati che le informazioni siano corrette e che l'URL del sito web della tua azienda funzioni. Se il sito web non è attivo, Google potrebbe non essere in grado di elaborare la tua richiesta e rifiutarla.
Assicurati che l'indirizzo email di contatto dell'API che fornisci rimandi a una posta in arrivo monitorata regolarmente. Il team di conformità dell'API di Google potrebbe contattare questo indirizzo email durante la procedura di revisione per richiedere chiarimenti. Se non è possibile contattarti, Google potrebbe non continuare con la tua richiesta.
Puoi modificare l'indirizzo email di contatto dell'API nel Centro API. Mantieni aggiornate queste informazioni, anche dopo la procedura di richiesta, in modo che Google possa inviarti importanti annunci di servizio.
Una volta completata la procedura di richiesta, il token sviluppatore viene visualizzato nel Centro API con uno dei seguenti risultati:
- Il token sviluppatore ha il livello di accesso Explorer con lo stato Approvato. Ciò significa che Google è riuscita a esaminare e approvare automaticamente la tua richiesta di token sviluppatore per il livello di accesso Explorer. Puoi iniziare a effettuare chiamate API al tuo account di produzione o all' account di test.
- Il token sviluppatore ha il livello di accesso all'account di test con lo stato In attesa di approvazione. Ciò significa che Google non è riuscita a esaminare e approvare automaticamente la tua richiesta di token sviluppatore per il livello di accesso Explorer. Puoi iniziare a effettuare chiamate API agli account di test. Una volta completata questa guida, ti invitiamo a scoprire come richiedere il livello di accesso di base
Verifica se hai eseguito l'accesso a un account amministratore Google Ads
Per accedere al token sviluppatore, devi accedere al tuo account amministratore Google Ads, che non può essere un account amministratore di test di Google Ads.
Per verificare se hai eseguito l'accesso all'account amministratore Google Ads:
Vai all'indirizzo https://ads.google.com/aw/apicenter nel browser web.
Se hai eseguito l'accesso a un account cliente, nella pagina verrà visualizzato il messaggio Il Centro API è disponibile solo per gli account amministratore.
Se nell'angolo in alto a destra viene visualizzato Account di test in rosso, il tuo account è un account amministratore di test o un inserzionista di test.
Dove trovare il token sviluppatore
Puoi trovare il token sviluppatore, se esiste, nella pagina Centro API del tuo account amministratore Google Ads.