Al tuo progetto cloud Google Cloud 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 quotidianamente. L'utilizzo consentito determina le funzionalità specifiche dell'API Google Ads che il progetto è autorizzato a utilizzare.
Livelli di accesso
Nella tabella sono elencati quattro diversi livelli di accesso all'API in ordine. Se non hai ancora accesso all'API Google Ads, puoi iniziare abilitando l'API per ottenere il livello di accesso all'account di test per il tuo progetto Google Cloud. Puoi aumentare il livello di accesso completando alcuni passaggi aggiuntivi nella richiesta.
| Livello di accesso | Può accedere a... | Limite di operazioni giornaliere 1 | 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 | Richiedi l'accesso all'account di test | |
| 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 |
Richiedi l'accesso Explorer | |
| Livello di accesso di 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 | |
| Livello di accesso 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 |
1 "Al giorno" si basa su un periodo 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.
Livello di accesso all'account di test
Dopo aver abilitato l'API Google Ads, al tuo progetto Google Cloud viene concesso il livello di accesso all'account di test. Ciò significa che il progetto può effettuare richieste API Google Ads solo per gli account di test.
Richiedi il livello di accesso all'account di test
Abilita l'API Google Ads nel tuo progetto cloud Google per ottenere automaticamente il livello di accesso all'account di test 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 test sia per quelli 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 tuo progetto Google Cloud 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 | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| Fatturazione e pagamento dell'account | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Richiedi il livello di accesso Explorer
- Vai alla pagina Panoramica dell'API Google Ads nel tuo progetto Google Cloud.
- Verifica che la pagina mostri il tuo livello di accesso attuale come Test.
- Fai clic per espandere la sezione Esegui l'upgrade del livello di accesso.
- Verifica che il livello di accesso successivo sia visualizzato come Explorer.
- 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 al livello di accesso Explorer dopo che hai inviato la richiesta.
Livello di accesso di base
Il livello di accesso di base consente al tuo progetto Google Cloud di effettuare richieste 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, mentre 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
- Vai alla pagina Panoramica dell'API Google Ads nel tuo progetto Google Cloud.
- Verifica che la pagina mostri il tuo livello di accesso attuale come Explorer.
- Fai clic per espandere la sezione Esegui l'upgrade del livello di accesso.
- Verifica che il livello di accesso successivo sia visualizzato come Di base.
- Verifica che non siano presenti avvisi che indicano che non hai completato la verifica del brand per il tuo progetto. In caso contrario, segui le istruzioni per completare la verifica del brand prima di continuare.
- 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 al livello di accesso di base dopo che hai inviato 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 le singole funzionalità potrebbero comunque avere limiti di frequenza e restrizioni specifici per tali funzionalità, che continueranno a essere applicati anche se il tuo progetto ha il livello di accesso standard.
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 molti utenti.
Richiedi il livello di accesso standard
- Vai alla pagina Panoramica dell'API Google Ads nel tuo progetto Google Cloud.
- Verifica che la pagina mostri il tuo livello di accesso attuale come Di base.
- Fai clic per espandere la sezione Esegui l'upgrade del livello di accesso.
- Verifica che il livello di accesso successivo sia visualizzato come Standard.
- Fai clic sul pulsante Avvia richiesta per avviare la richiesta del livello di accesso standard.
La richiesta di accesso standard prevede un controllo manuale dettagliato della tua applicazione. Preparati a rispondere alle domande sulle funzionalità del tuo strumento e sul suo pubblico di destinazione. Se il tuo strumento viene utilizzato da utenti esterni, preparati a fornire l'accesso di accesso demo al tuo strumento. Tieni presente che il tuo strumento deve rispettare le Funzionalità minime obbligatorie.
Durante la procedura di revisione, il team di conformità di Google ti contatterà utilizzando il tuo indirizzo email. Assicurati di rispondere tempestivamente alle domande del team di conformità per avanzare con la richiesta di accesso standard. Al termine della revisione, Google ti invierà un'email con il risultato 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 relativi ai limiti di frequenza, consulta la sezione 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, prestazioni API e considerazioni sulla latenza. Per scoprire di più su queste restrizioni, consulta la documentazione relativa alle quote API quotas.
Utilizzo consentito
L'utilizzo consentito si applica solo ai progetti Google Cloud con livelli di accesso standard. L'utilizzo consentito viene assegnato in base all'utilizzo previsto dell'API Google Ads. Queste autorizzazioni determinano le funzionalità dell'API che il tuo strumento può utilizzare, come descritto nella tabella seguente:
| Utilizzo consentito | Descrizione |
|---|---|
| Creazione / gestione degli annunci | Fornisci 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. |
| 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 suggerimenti | 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'utilizzo consentito
Se il tuo progetto Google Cloud è stato approvato per il livello di accesso 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.