Livelli di accesso e utilizzo consentito

Al tuo progetto Google Cloud vengono assegnati un livello di accesso e un "utilizzo consentito". Il livello di accesso determina se puoi apportare modifiche agli account di produzione e definisce il numero di operazioni e richieste che puoi fare quotidianamente. L'utilizzo consentito determina le funzionalità specifiche dell'API Google Ads che il progetto può utilizzare.

Punto chiave: Vuoi iniziare a utilizzare l'API Google Ads? I token sviluppatore sono stati ritirati il 9 settembre 2026 e i livelli di accesso all'API sono ora gestiti per progetto Google Cloud. Dopo aver abilitato l'API Google Ads (che concede l'accesso di test), puoi richiedere immediatamente l'accesso Explorer nella pagina Panoramica dell'API Google Ads della console Google Cloud (nella maggior parte dei casi, la revisione automatizzata e l'approvazione sono automatiche e consentono di eseguire fino a 2880 operazioni al giorno sugli account di produzione). Per la configurazione end-to-end, consulta la guida rapida per effettuare la prima chiamata o la guida al server MCP di Google Ads.

Vai alla panoramica dell'API Google Ads nella console Cloud

Livelli di accesso

Nella tabella sono elencati quattro diversi livelli di accesso all'API. Se non hai ancora l'accesso all'API Google Ads, puoi iniziare abilitando l'API per ottenere il livello di accesso di test per il tuo progetto Google Cloud, quindi richiedere l'accesso Explorer nella pagina Panoramica dell'API Google Ads per accedere agli account di produzione.

Livello di accesso	Può accedere…	Limite di operazioni giornaliere ^1	Come presentare domanda	Quanto tempo richiedono in genere le revisioni?
Test	Account di prova	15.000 operazioni al giorno	Richiedi l'accesso ai test
Spazio di esplorazione	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	Richiedi l'accesso Explorer
Base	Account di test e di produzione	15.000 operazioni al giorno sia per gli account di test sia per quelli di produzione	Richiedi l'accesso di base
Standard	Account di test e di produzione	Operazioni illimitate al giorno sia per gli account di test sia per quelli di produzione	Richiedi l'accesso standard	10 giorni lavorativi

¹ "Al giorno" si basa su un periodo di tempo di 24 ore in cui sono state effettuate richieste API con il tuo progetto Google Cloud. La tua applicazione riceverà un errore se supera il limite di richieste per il tuo livello di accesso nelle ultime 24 ore.

Controlla l'accesso

Dopo aver abilitato l'API Google Ads, al tuo progetto Google Cloud viene concesso l'accesso di test. Ciò significa che il progetto può effettuare richieste API Google Ads solo per gli account di test.

Importante: consulta la guida agli account di prova per scoprire di più su come creare un account di prova.

Richiedi l'accesso di prova

Abilita l'API Google Ads nel tuo progetto Google Cloud per ottenere automaticamente l'accesso di prova per il tuo progetto.

Livello di accesso Explorer

Dopo aver completato la registrazione iniziale all'API Google Ads, Google potrebbe consentirti di richiedere il livello di accesso Explorer.

Il livello di accesso Explorer consente al tuo progetto Google Cloud di effettuare richieste API Google Ads sia per gli account di prova sia per quelli di produzione. Gli account di produzione sono tutti gli account che pubblicano annunci Google reali e pubblicati, mentre gli account di test non pubblicano annunci.

Il livello di accesso Explorer consente al tuo progetto Google Cloud di eseguire fino a 2880 operazioni al giorno sugli account di produzione. Questo è sufficiente per la maggior parte degli sviluppatori per iniziare a utilizzare l'API e creare un'automazione 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 il livello di accesso standard.

Funzionalità limitata	Servizi e metodi limitati
Creazione account	CustomerService.CreateCustomerClient
Gestione utenti	CustomerUserAccessInvitationService CustomerUserAccessService
Pianificazione	KeywordPlanService KeywordPlanIdeaService KeywordPlanCampaignService KeywordPlanCampaignKeywordService KeywordPlanAdGroupService KeywordPlanAdGroupKeywordService AudienceInsightsService ReachPlanService
Fatturazione e pagamento dell'account	PaymentsAccountService BillingSetupService AccountBudgetProposalService InvoiceService

Richiedi il livello di accesso Explorer

1. Vai alla pagina Panoramica dell'API Google Ads nel tuo progetto Google Cloud.
2. Verifica che la pagina mostri il tuo livello di accesso attuale come Test.
3. Fai clic per espandere la sezione Esegui l'upgrade del livello di accesso.
4. Verifica che il Livello di accesso successivo sia visualizzato come Explorer.
5. Fai clic sul pulsante Richiedi l'accesso per richiedere il livello di accesso Explorer.

Google potrebbe eseguire automaticamente l'upgrade del livello di accesso all'API del tuo progetto a Explorer dopo l'invio della richiesta.

Livello di accesso di base

Il livello di accesso Base consente al tuo progetto Google Cloud di effettuare richieste API Google Ads sia per gli account di prova sia per quelli di produzione. Gli account di produzione sono tutti gli account che pubblicano annunci Google reali e pubblicati. Gli account di test non pubblicano annunci.

Il livello di accesso di base consente al tuo progetto Google Cloud di eseguire fino a 15.000 operazioni al giorno. Questo è sufficiente per la maggior parte degli sviluppatori.

Richiedi il livello di accesso di base

Nota: il completamento della verifica del brand per il tuo progetto Google Cloud è un prerequisito per richiedere il livello di accesso di base. Per saperne di più, consulta la guida alla verifica del brand.

1. Vai alla pagina Panoramica dell'API Google Ads nel tuo progetto Google Cloud.
2. Verifica che la pagina mostri il tuo livello di accesso attuale come Explorer.
3. Fai clic per espandere la sezione Esegui l'upgrade del livello di accesso.
4. Verifica che il Livello di accesso successivo sia visualizzato come Base.
5. Verifica che non siano presenti avvisi che indicano che non hai completato la verifica del brand per il tuo progetto. In questo caso, segui le istruzioni per completare la verifica del brand prima di continuare.
6. Fai clic sul pulsante Richiedi l'accesso per richiedere il livello di accesso di base.

Google potrebbe eseguire automaticamente l'upgrade del livello di accesso all'API del tuo progetto a Base una volta inviata la richiesta.

Livello di accesso standard

Il livello di accesso standard consente al tuo progetto Google Cloud di eseguire un numero illimitato di operazioni al giorno per tutti i servizi. I singoli servizi e funzionalità potrebbero comunque avere limitazioni di frequenza e restrizioni specifiche per queste funzionalità, che continueranno ad applicarsi anche se il tuo progetto ha il livello di accesso Standard.

Il livello di accesso Standard viene concesso solo agli sviluppatori che richiedono operazioni illimitate con l'API Google Ads, ad esempio grandi aziende o strumenti che servono molti utenti.

Richiedi il livello di accesso standard

1. Vai alla pagina Panoramica dell'API Google Ads nel tuo progetto Google Cloud.
2. Verifica che la pagina mostri il tuo livello di accesso attuale come Di base.
3. Fai clic per espandere la sezione Esegui l'upgrade del livello di accesso.
4. Verifica che il Livello di accesso successivo sia visualizzato come Standard.
5. Fai clic sul pulsante Avvia richiesta per avviare la richiesta di accesso standard.

La richiesta di accesso standard prevede un controllo manuale dettagliato della tua applicazione. Preparati a rispondere alle domande sulla funzionalità dello strumento e sul suo pubblico di destinazione. Se il tuo strumento viene utilizzato da utenti esterni, preparati a fornire un accesso demo al tuo strumento. Tieni presente che lo strumento deve essere conforme alle funzionalità minime obbligatorie.

Durante la procedura di revisione, il team di Google Compliance comunicherà con te utilizzando il tuo indirizzo email. Assicurati di rispondere tempestivamente alle domande del team di conformità per portare avanti la tua richiesta di accesso standard. Al termine della revisione, Google ti invierà un'email con l'esito finale della procedura di revisione.

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 di limitazione di frequenza, consulta Tipi di errori.

I singoli servizi possono applicare limiti e restrizioni delle quote aggiuntivi per motivi quali limitazioni di progettazione del prodotto, limitazioni delle norme del prodotto, considerazioni sulle prestazioni e sulla latenza delle API. Per saperne di più su queste limitazioni, consulta la documentazione sulle quote API.

Uso consentito

L'utilizzo consentito si applica solo ai progetti Google Cloud con livello di accesso standard. L'utilizzo consentito viene assegnato in base all'utilizzo previsto dell'API Google Ads. Queste autorizzazioni determinano quali funzionalità dell'API può utilizzare il tuo strumento, come descritto nella tabella seguente:

Utilizzo consentito	Descrizione
Creazione / gestione degli annunci	Fornire l'accesso a tutti i servizi dell'API per la creazione e la gestione di campagne Google Ads, gruppi di annunci, annunci e parole chiave.
Rapporti	Effettua solo richieste GoogleAdsService.Search o GoogleAdsService.SearchStream o chiamate di sola lettura. Questo vale per gli sviluppatori che utilizzano l'API solo per richiedere statistiche.
Ricerca di parole chiave e consigli	Consenti al progetto Google Cloud 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.

Modifica l'uso consentito

Se il tuo progetto Google Cloud è stato approvato per il livello di accesso Standard, puoi compilare la richiesta di aggiornamento dell'utilizzo consentito. Compila la richiesta se vuoi aggiornare l'utilizzo consentito o concedere ai tuoi clienti l'accesso al tuo strumento.