A ogni token sviluppatore dell'API Google Ads viene assegnato un livello di accesso e un "uso consentito". Il livello di accesso determina se puoi influire sugli account di produzione e sul numero di operazioni e richieste che puoi eseguire ogni giorno. L'uso consentito determina le funzionalità specifiche dell'API Google Ads che il token sviluppatore è autorizzato a utilizzare.
Livelli di accesso
Nella tabella sono presenti tre diversi livelli di accesso elencati in ordine. Se non disponi ancora dell'accesso all'API Google Ads, puoi iniziare registrandoti per ottenere l'accesso all'account di prova. Puoi aumentare il livello di accesso completando alcuni passaggi aggiuntivi nell'applicazione.
| Livello di accesso | Può accedere... | Limite operazioni giornaliere1 | Applica |
|---|---|---|---|
| Testa l'accesso all'account | Account di prova | 15.000 operazioni / giorno | Istruzioni |
| Accesso di base | Account di test e produzione | 15.000 operazioni / giorno | Istruzioni |
| Accesso standard | Account di test e produzione | Operazioni illimitate al giorno | Istruzioni |
1 L'opzione "Al giorno" si basa su un periodo di tempo mobile di 24 ore in cui sono state effettuate richieste API con il tuo token sviluppatore. L'applicazione riceverà un errore se supera il limite di richieste per il tuo livello di accesso nelle ultime 24 ore.
Testa l'accesso all'account
Dopo aver completato la registrazione iniziale all'API Google Ads, ti verrà inviato un token sviluppatore con il livello di accesso all'account di prova. Ciò significa che il token sviluppatore può effettuare richieste API Google Ads solo per gli account di prova.
Richiedere l'accesso all'account di prova
Completa la registrazione all'API Google Ads nell'interfaccia web di Google Ads per ottenere automaticamente il livello di accesso all'account di prova.
Accesso di base
L'accesso di base consente al token sviluppatore di effettuare richieste API Google Ads sia per gli account di prova che per gli account di produzione. Gli account di produzione sono account che pubblicano annunci Google reali e attivi, mentre gli account di prova non pubblicano annunci.
Il livello di accesso di base consente al token sviluppatore di eseguire fino a 15.000 operazioni al giorno. Ciò è sufficiente per la maggior parte degli sviluppatori.
Richiedere l'accesso di base
Se al momento hai un token sviluppatore a livello di accesso all'account di prova e vuoi richiedere l'accesso all'account di produzione, compila il modulo di richiesta per l'accesso di base. Assicurati di aver completato questi passaggi:
- Assicurati di avere già un token sviluppatore con livello di accesso all'account di prova.
- Assicurati che l'email di contatto per l'API nel Centro API sia aggiornata. Non potrai completare la procedura di richiesta senza un indirizzo email valido e regolarmente controllato. Assicurati di aver collegato tutti i tuoi account Google Ads attivi all'account amministratore con il token API.
Accesso standard
L'accesso standard consente al token sviluppatore di eseguire un numero illimitato di operazioni al giorno per la maggior parte dei servizi. Sono inclusi, a titolo esemplificativo,
GoogleAdsService Search e
SearchStream. Per ulteriori dettagli su limiti ed eccezioni all'accesso standard, consulta Quote API.
Il livello di accesso standard viene concesso solo agli sviluppatori che richiedono operazioni illimitate per l'API Google Ads, ad esempio grandi aziende o strumenti che servono molti utenti.
Indipendentemente dal livello di accesso, tutte le operazioni API sono soggette a limiti di frequenza di sistema. Per scoprire di più su come gestire gli errori relativi ai limiti di frequenza, consulta Tipi di errore.
Richiedere l'accesso standard
Se al momento disponi di un livello di accesso di base e vuoi richiedere l'accesso illimitato all'API Google Ads, compila il modulo di richiesta di accesso standard.
Se il tuo strumento è esterno, preparati a fornire una demo di accesso allo strumento. Tieni presente che lo strumento deve rispettare le Funzionalità minime richieste.
Uso consentito
L'uso consentito si applica solo ai token di accesso di base e standard. L'uso consentito viene assegnato in base all'uso previsto dell'API Google Ads. Queste autorizzazioni determinano per quali funzionalità dell'API è possibile utilizzare un token, come elaborato nella seguente tabella:
| Uso consentito | Descrizione |
|---|---|
| Creazione / gestione degli annunci | Fornisci l'accesso a tutti i servizi dell'API per creare e gestire campagne, gruppi di annunci, annunci e parole chiave Google Ads. |
| Report | Effettua solo richieste GoogleAdsService.Search o GoogleAdsService.SearchStream oppure chiamate di sola lettura. Questo articolo è rivolto agli sviluppatori che utilizzano l'API solo per richiedere statistiche.
|
| Ricerca di parole chiave e consigli | Consenti al token di accedere a RecommendationService, KeywordPlanIdeaService e a KeywordPlanService. Viene utilizzato solo dagli strumenti che richiedono suggerimenti per semplificare la creazione e la gestione delle campagne Google Ads. |
Modifica dell'utilizzo consentito
Se hai ricevuto l'approvazione per il livello di accesso di base o standard, puoi compilare la richiesta di aggiornamento dell'utilizzo consentito. Compila la domanda se desideri aggiornare l'uso consentito o concedere ai tuoi clienti l'accesso al tuo strumento.