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 modificare gli account di produzione e il numero di operazioni e richieste che puoi eseguire ogni giorno. L'utilizzo consentito determina le funzionalità specifiche dell'API Google Ads che il token sviluppatore è autorizzato a utilizzare.
Livelli di accesso
Nella tabella sono elencati in ordine tre diversi livelli di accesso. Se non hai ancora 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 a… | Limite di funzionamento giornaliero1 | Applica |
|---|---|---|---|
| Testare l'accesso all'account | Account di prova | 15.000 operazioni al giorno | Istruzioni |
| Accesso di base | Account di test e di produzione | 15.000 operazioni al giorno | Istruzioni |
| Accesso standard | Account di test e di produzione | Operazioni illimitate al giorno | Istruzioni |
1 "Al giorno" si basa su un periodo di tempo scorrevole di 24 ore in cui sono state effettuate richieste all'API con il tuo token sviluppatore. La tua applicazione riceverà un messaggio di errore se supera il limite di richieste per il tuo livello di accesso nelle ultime 24 ore.
Testare l'accesso all'account
Dopo aver completato la registrazione iniziale per l'API Google Ads, ti viene assegnato un token sviluppatore con il livello di accesso all'account di test. Ciò significa che il token sviluppatore può inviare richieste all'API Google Ads solo per gli account di test.
Richiesta di accesso all'account di test
Completa la registrazione all'API Google Ads nell'interfaccia web di Google Ads per ottenere automaticamente il livello di accesso dell'account di test.
Accesso di base
L'accesso di base consente al token sviluppatore di effettuare richieste all'API Google Ads sia per gli account di test sia per quelli di produzione. Gli account di produzione sono tutti gli account che pubblicano annunci Google reali e attivi. Gli account di test non pubblicano annunci.
Il livello di accesso di base consente al token sviluppatore di eseguire fino a 15.000 operazioni al giorno. Questo è sufficiente per la maggior parte degli sviluppatori.
Richiesta di accesso di base
Se disponi di un token sviluppatore a livello di accesso all'account di test e vuoi richiedere l'accesso all'account di produzione, compila il modulo di richiesta di accesso di base. Assicurati di aver completato questi passaggi:
- Assicurati di avere già un token sviluppatore con il livello di accesso dell'account di test.
- Assicurati che l'indirizzo email di contatto dell'API nel Centro API sia aggiornato. Per visualizzare il Centro API, devi aver eseguito l'accesso al tuo account amministratore. Non potrai completare la procedura di richiesta senza un indirizzo email valido controllato regolarmente. Assicurati di aver collegato tutti gli 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. Ciò include, a titolo esemplificativo,
GoogleAdsService Search e
SearchStream. Per maggiori 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 dell'API Google Ads, ad esempio grandi aziende o strumenti che servono molti utenti.
Indipendentemente dal livello di accesso, tutte le operazioni dell'API sono soggette ai limiti di frequenza del sistema. Per scoprire di più su come gestire gli errori di limite di frequenza, consulta Tipi di errori.
Richiesta di accesso standard
Se al momento disponi del livello di accesso di base e vuoi richiedere operazioni illimitate con l'API Google Ads, compila il modulo di richiesta di accesso standard.
Se lo strumento è esterno, preparati a fornire l'accesso di prova allo strumento. Tieni presente che lo strumento deve essere conforme alle funzionalità minime obbligatorie.
Utilizzo consentito
L'utilizzo consentito si applica solo ai token di accesso di base e standard. L'utilizzo consentito viene assegnato in base all'utilizzo previsto dell'API Google Ads. Queste autorizzazioni determinano per quali funzionalità dell'API è possibile utilizzare un token, come elaborato nella tabella seguente:
| Utilizzo consentito | Descrizione |
|---|---|
| Creazione / gestione degli annunci | Fornisce l'accesso a tutti i servizi dell'API per la creazione e la gestione di campagne, gruppi di annunci, annunci e parole chiave Google Ads. |
| Rapporti | Effettua solo richieste GoogleAdsService.Search
o GoogleAdsService.SearchStream
oppure chiamate di sola lettura. È destinato 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 KeywordPlanService. Viene utilizzato solo dagli strumenti che richiedono suggerimenti per contribuire a semplificare la creazione e la gestione delle campagne Google Ads. |
Modifica dell'uso consentito
Se hai ricevuto l'approvazione per il livello di accesso di base o standard, puoi compilare la richiesta di aggiornamento dell'uso consentito. Compila la domanda se vuoi aggiornare l'utilizzo consentito o concedere ai tuoi clienti l'accesso allo strumento.