A ogni token sviluppatore dell'API Google Ads viene assegnato un livello di accesso e un "utilizzo consentito". Il livello di accesso determina se puoi influire sugli 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 quattro diversi livelli di accesso ai token sviluppatore. Se non hai ancora accesso all'API Google Ads, puoi iniziare registrandoti per ottenere un token sviluppatore con il livello di accesso all'account di test. Puoi aumentare il livello di accesso completando alcuni passaggi aggiuntivi nell'applicazione.
| Livello di accesso | Può accedere a... | Limite di operazioni giornaliere1 | Come presentare domanda | In genere, quanto tempo richiedono le revisioni? |
|---|---|---|---|---|
| Livello di accesso all'account di test | Account di test | 15.000 operazioni al giorno | Istruzioni | |
| Livello di accesso Explorer | Account di test e di produzione | 2880 operazioni al giorno per gli account di produzione 15.000 operazioni al giorno per gli account di test |
Istruzioni | |
| Livello di accesso di base | Account di test e di produzione | 15.000 operazioni al giorno per gli account di test e di produzione | Istruzioni | 5 giorni lavorativi |
| Livello di accesso standard | Account di test e di produzione | Operazioni illimitate al giorno per gli account di test e di produzione | Istruzioni | 10 giorni lavorativi |
1 "Al giorno" si basa su un periodo di tempo di 24 ore in cui sono state effettuate richieste API con il tuo token sviluppatore. Se superi il limite di richieste per il tuo livello di accesso nelle ultime 24 ore, la tua applicazione riceverà un errore.
Livello di accesso all'account di test
Dopo aver completato la registrazione iniziale all'API Google Ads, ti viene rilasciato un token sviluppatore con il livello di accesso all'account di test. Ciò significa che il token sviluppatore può effettuare richieste all'API Google Ads solo per gli account di test.
Come richiedere il livello di accesso all'account di test
Livello di accesso Explorer
Dopo aver completato la registrazione iniziale all'API Google Ads, in alcuni casi Google potrebbe eseguire automaticamente l'upgrade del tuo token sviluppatore dal livello di accesso all'account di test al livello di accesso Explorer. Il livello di accesso Explorer consente al token sviluppatore di effettuare richieste all'API Google Ads sia per gli account di test sia per gli account di produzione. Gli account di produzione sono tutti gli account che pubblicano annunci Google reali e attivi, mentre gli account di test non pubblicano annunci.
Il livello di accesso Explorer consente al token sviluppatore di eseguire fino a 2880 operazioni al giorno per gli account di produzione. Questo è sufficiente per la maggior parte degli sviluppatori per iniziare a utilizzare l'API e creare automazioni di base.
Il livello di accesso Explorer limita l'accesso alle seguenti funzionalità. Se devi utilizzare queste funzionalità, devi richiedere il livello di accesso di base o standard.
| Funzionalità limitate | Servizi e metodi limitati |
|---|---|
| Creazione account | CustomerService.CreateCustomerClient |
| Gestione utenti | CustomerUserAccessInvitationServiceCustomerUserAccessService
|
| Pianificazione |
KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceKeywordPlanIdeaServiceReachPlanService |
| Fatturazione e pagamento dell'account |
PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Come richiedere il livello di accesso Explorer
Completa la registrazione all'API Google Ads nell'interfaccia web di Google Ads. In alcuni casi, Google potrebbe eseguire automaticamente l'upgrade del tuo token sviluppatore al livello di accesso Explorer una volta completata la registrazione.
Livello di accesso di base
Il livello di accesso di base consente al token sviluppatore di effettuare richieste all'API Google Ads sia per gli account di test sia per gli account di produzione. Gli account di produzione sono tutti gli account che pubblicano annunci Google reali e attivi, mentre 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.
Come richiedere il livello di accesso di base
Se hai un token sviluppatore con il livello di accesso all'account di test o il livello di accesso Explorer, puoi richiedere il livello di accesso di base nel seguente modo:
Vai all'indirizzo https://ads.google.com/aw/apicenter nel browser web. Se richiesto, accedi al tuo account amministratore Google Ads.
Verifica che il livello di accesso sia Account di test o Explorer.
Assicurati che l'indirizzo email di contatto dell'API nel Centro API sia aggiornato. Non potrai completare la procedura di richiesta senza un indirizzo email valido e controllato regolarmente. Assicurati di aver collegato tutti i tuoi account Google Ads attivi all'account amministratore Google Ads con il token API.
Fai clic sulla freccia menu a discesa accanto al livello di accesso e poi sul link Richiedi l'accesso di base.
Completa la verifica del brand dei progetti Google Cloud
L'API Google Ads utilizza lo stato di verifica del brand dei progetti Google Cloud associati a un token sviluppatore durante la revisione delle richieste per il livello di accesso di base. Puoi completare la procedura di verifica del brand nel tuo progetto Google Cloud per velocizzare la procedura di revisione della tua richiesta di accesso di base. In alcuni casi, Google potrebbe anche chiederti di completare la verifica del brand nei tuoi progetti Google Cloud come prerequisito per l'elaborazione della tua richiesta di accesso di base. Per saperne di più, consulta la guida alla verifica del brand.
Livello di accesso standard
Il livello di 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 maggiori dettagli
sui limiti e sulle eccezioni al livello di accesso standard, consulta Quote
API.
Il livello di accesso standard viene concesso solo agli sviluppatori che richiedono operazioni API Google Ads illimitate, ad esempio le grandi aziende o gli strumenti che servono a molti utenti.
Come richiedere il livello di accesso standard
Se hai un token sviluppatore con il livello di accesso di base, puoi richiedere il livello di accesso standard nel seguente modo:
Vai all'indirizzo https://ads.google.com/aw/apicenter nel browser web. Se richiesto, accedi al tuo account amministratore Google Ads.
Verifica che il livello di accesso sia Di base.
Assicurati che l'indirizzo email di contatto dell'API nel Centro API sia aggiornato. Non potrai completare la procedura di richiesta senza un indirizzo email valido e controllato regolarmente. Assicurati di aver collegato tutti i tuoi account Google Ads attivi all'account amministratore Google Ads con il token API.
Fai clic sulla freccia menu a discesa accanto al livello di accesso e poi sul link Richiedi l'accesso standard.
Se il tuo strumento viene utilizzato da utenti esterni, preparati a fornire l'accesso di accesso demo allo strumento. Tieni presente che il tuo strumento deve essere conforme alla funzionalità minima richiesta.
Quote API e limiti di frequenza del sistema
Indipendentemente dal livello di accesso, tutte le operazioni API sono soggette a limiti di frequenza del sistema, che limitano il numero di operazioni che puoi eseguire in un periodo di tempo, ovvero il numero di operazioni all'ora. Per scoprire di più su come gestire gli errori relativi ai limiti di frequenza, consulta Tipi di errori.
I singoli servizi possono applicare limiti e restrizioni di quota aggiuntivi per motivi quali limitazioni di progettazione del prodotto, restrizioni delle norme del prodotto, considerazioni sul rendimento e sulla latenza dell'API. Per scoprire di più su queste restrizioni, consulta la documentazione sulle quote API API.
Utilizzo consentito
L'utilizzo consentito si applica solo ai token sviluppatore con i livelli di accesso di base e standard. L'utilizzo consentito viene assegnato in base all'utilizzo previsto dell'API Google Ads. Queste autorizzazioni determinano le funzionalità dell'API per cui è possibile utilizzare un token sviluppatore, come descritto 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 campagne, gruppi di annunci, annunci e parole chiave Google Ads. |
| Report | Effettua solo richieste GoogleAdsService.Search
o GoogleAdsService.SearchStream
o chiamate di sola lettura. Questo è per gli sviluppatori che utilizzano l'API solo per
richiedere statistiche.
|
| Ricerca di parole chiave e consigli | Consente al token sviluppatore di accedere a RecommendationService,
KeywordPlanIdeaService,
e KeywordPlanService.
Questo viene utilizzato solo dagli strumenti che richiedono suggerimenti per facilitare la
creazione e la gestione delle campagne Google Ads.
|
Come modificare l'utilizzo consentito
Se il tuo token sviluppatore è stato approvato per il livello di accesso di base o standard, puoi compilare la richiesta per aggiornare l'utilizzo consentito. Compila la richiesta se vuoi aggiornare l'utilizzo consentito o concedere ai tuoi clienti l'accesso al tuo strumento.