Per discutere e fornire feedback sui nostri prodotti, unisciti al canale Discord ufficiale di Google Ads nel server della community di Google Advertising and Measurement.

Questa pagina è stata tradotta dall'API Cloud Translation.

Livelli di accesso e utilizzo consentito

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 giornalmente. 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 quattro diversi livelli di accesso ai token sviluppatore in ordine. Se non hai ancora accesso all'API Google Ads, puoi iniziare registrandoti per ottenere un token sviluppatore con 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 giornaliero di operazioni¹	Come presentare domanda	Quanto tempo richiedono in genere le revisioni?
Livello di accesso all'account di prova	Account di prova	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	2 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

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

Livello di accesso all'account di prova

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 API Google Ads solo per gli account di test.

Come richiedere il livello di accesso all'account di test

Completa la registrazione all'API Google Ads nell'interfaccia web di Google Ads per ottenere automaticamente l'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 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 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. Gli account di test non pubblicano annunci.

Il livello di accesso Explorer consente al token sviluppatore di eseguire fino a 2880 operazioni al giorno sugli account di produzione. È 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 il livello di accesso standard.

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

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 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. 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 livello di accesso all'account di test e vuoi richiedere l'accesso all'account di produzione, compila il modulo di richiesta per il livello di accesso di base. Assicurati di aver completato questi passaggi:

Assicurati di disporre già di un token sviluppatore con livello di accesso all'account di prova.
Assicurati che l'email di contatto API nel Centro API sia aggiornata. Per visualizzare il Centro API, devi aver eseguito l'accesso al tuo account amministratore Google Ads. 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.

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. Ciò include, a titolo esemplificativo, GoogleAdsService Search e SearchStream. Per ulteriori 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, come grandi aziende o strumenti che servono molti utenti.

Come richiedere il livello di accesso standard

Se hai un token sviluppatore con livello di accesso di base e vuoi richiedere operazioni illimitate dell'API Google Ads, compila il modulo di richiesta del livello di accesso standard.

Se il tuo strumento è esterno, preparati a fornire l'accesso demo al tuo strumento. Tieni presente che il tuo strumento deve essere conforme alle funzionalità minime obbligatorie.

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 limite di frequenza, consulta la sezione Tipi di errore.

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

Uso consentito

L'utilizzo consentito si applica solo ai token sviluppatore con livelli 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 può essere utilizzato un token sviluppatore, come descritto nella tabella seguente:

Uso 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. Questo è per gli sviluppatori che utilizzano l'API solo per richiedere statistiche.
Ricerca di parole chiave e consigli	Consenti al token sviluppatore di accedere a `RecommendationService`, `KeywordPlanIdeaService`, e `KeywordPlanService`. 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 per il livello di accesso standard, puoi compilare la richiesta di aggiornamento dell'utilizzo consentito. Compila la richiesta se vuoi aggiornare il tuo utilizzo consentito o concedere ai tuoi clienti l'accesso al tuo strumento.