Al tuo progetto cloud Google Cloud viene assegnato 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 è 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 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? |
|---|---|---|---|---|
| Test | Account di test | 15.000 operazioni al giorno | Richiedi l'accesso 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 Spazio di esplorazione | |
| Base | Account di test e di produzione | 15.000 operazioni al giorno per gli account di test e di produzione | Richiedi l'accesso di base | |
| Standard | Account di test e di produzione | Operazioni illimitate al giorno per gli account di test e 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. Se superi il limite di richieste per il tuo livello di accesso nelle ultime 24 ore, la tua applicazione riceverà un errore.
Controlla l'accesso
Dopo aver abilitato l'API Google Ads, al tuo progetto Google Cloud viene concesso l'accesso Test. Ciò significa che il progetto può effettuare richieste API Google Ads solo per gli account di test.
Richiedi l'accesso Test
Abilita l'API Google Ads nel tuo progetto cloud Google Cloud per ottenere automaticamente l'accesso Test per il tuo progetto.
Livello di accesso Spazio di esplorazione
Dopo aver completato la registrazione iniziale all'API Google Ads, Google potrebbe consentirti di richiedere il livello di accesso Spazio di esplorazione.
Il livello di accesso Spazio di esplorazione consente al tuo progetto Google Cloud 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, mentre gli account di test non pubblicano annunci.
Il livello di accesso Spazio di esplorazione 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 Spazio di esplorazione limita l'accesso alle seguenti funzionalità. Se devi utilizzare queste funzionalità, devi richiedere il livello di accesso 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 Spazio di esplorazione
- 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 Spazio di esplorazione.
- Fai clic sul pulsante Richiedi l'accesso per richiedere il livello di accesso Spazio di esplorazione.
Google potrebbe eseguire automaticamente l'upgrade del livello di accesso all'API del tuo progetto a Spazio di esplorazione dopo l'invio della richiesta.
Livello di accesso Base
Il livello di accesso Base consente al tuo progetto Google Cloud 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, mentre gli account di test non pubblicano annunci.
Il livello di accesso 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 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 Spazio di esplorazione.
- Fai clic per espandere la sezione Esegui l'upgrade del livello di accesso.
- Verifica che il livello di accesso successivo sia visualizzato come 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 Base.
Google potrebbe eseguire automaticamente l'upgrade del livello di accesso all'API del tuo progetto a Base dopo l'invio della 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, 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 a 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 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 applicazione per avviare l'applicazione con livello di accesso Standard.
La richiesta di accesso Standard prevede un controllo manuale dettagliato della tua applicazione. Preparati a rispondere alle domande sulla 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 query del team di conformità per avanzare con la 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 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, considerazioni relative a prestazioni e latenza dell'API. 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 livello 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 creare e gestire campagne Google Ads, gruppi di annunci, annunci e parole chiave. |
| 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. Questa opzione viene utilizzata 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.