A ogni token sviluppatore dell'API Google Ads vengono assegnati un livello di accesso e un "uso consentito". Il livello di accesso determina se puoi influire sugli account di produzione e sul 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 tre diversi livelli di accesso, in ordine. Se non disponi ancora dell'accesso all'API Google Ads, puoi iniziare registrandoti per ottenere l'accesso all'account di prova. Puoi aumentare il livello di accesso completando alcuni passaggi aggiuntivi nell'applicazione.
| Livello di accesso | Può accedere... | Limite di operazioni giornaliero1 | Applica |
|---|---|---|---|
| Testare l'accesso all'account | Account di prova | 15.000 operazioni / giorno | Istruzioni |
| Accesso di base | Account di test e di produzione | 15.000 operazioni / giorno | Istruzioni |
| Accesso standard | Account di test e di produzione | Operazioni illimitate al giorno | Istruzioni |
1 Il valore "Al giorno" si basa su un periodo di tempo scorrevole di 24 ore in cui sono state effettuate richieste API con il tuo token sviluppatore. L'applicazione riceverà un errore se supera il limite di richieste per il livello di accesso nelle ultime 24 ore.
Testare l'accesso all'account
Dopo aver completato la registrazione iniziale all'API Google Ads, ti viene inviato un token sviluppatore con il livello di accesso all'account di prova. Ciò significa che il token sviluppatore può effettuare richieste dell'API Google Ads solo contro gli account di prova.
Richiedere l'accesso all'account di prova
Completa la registrazione all'API Google Ads nell'interfaccia web di Google Ads per ottenere automaticamente il livello di accesso all'account di prova.
Accesso di base
L'accesso di base consente al token sviluppatore di effettuare richieste API Google Ads sia sugli account di prova sia sugli account di produzione. Gli account di produzione sono qualsiasi account che pubblica annunci Google reali e pubblicati, 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.
Richiedere l'accesso di base
Se al momento disponi di un token sviluppatore con livello di accesso all'account di prova e vuoi richiedere l'accesso all'account di produzione, compila il modulo di richiesta per l'accesso di base. Assicurati di aver completato questi passaggi:
- Assicurati di avere già un token sviluppatore con livello di accesso all'account di test.
- Accertati che l'email di contatto API nel Centro API sia aggiornata. Senza un indirizzo email valido e controllato regolarmente non potrai completare la procedura di richiesta. Assicurati di aver collegato tutti gli account Google Ads attivi all'account amministratore con il token API.
Accesso standard
L'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 ulteriori dettagli su limiti ed eccezioni all'accesso standard, consulta Quote API.
Il livello di accesso standard viene concesso solo agli sviluppatori che richiedono operazioni illimitate dell'API Google Ads, ad esempio grandi aziende o strumenti che servono molti utenti.
Indipendentemente dal livello di accesso, tutte le operazioni API sono soggette a limiti di frequenza di sistema. Per scoprire di più su come gestire gli errori della limitazione di frequenza, consulta Tipi di errore.
Richiesta dell'accesso standard
Se al momento disponi del livello di accesso di base e vuoi richiedere l'accesso a un numero illimitato di operazioni dell'API Google Ads, compila il modulo di richiesta di accesso standard.
Se il tuo strumento è esterno, preparati a fornire l'accesso allo strumento per la demo. Tieni presente che lo strumento deve rispettare la funzionalità minima richiesta.
Utilizzo consentito
L'utilizzo consentito si applica solo ai token di accesso di base e di accesso standard. L'uso consentito viene assegnato in base all'uso previsto dell'API Google Ads. Queste autorizzazioni determinano per quali funzionalità dell'API è possibile utilizzare un token, come illustrato nella tabella seguente:
| Utilizzo consentito | Descrizione |
|---|---|
| Creazione / gestione degli annunci | Forniscono l'accesso a tutti i servizi dell'API per creare e gestire campagne, gruppi di annunci, annunci e parole chiave Google Ads. |
| Reporting | Effettua solo richieste GoogleAdsService.Search
o GoogleAdsService.SearchStream
o chiamate di sola lettura. Questo è rivolto agli sviluppatori che utilizzano l'API solo per richiedere statistiche.
|
| Ricerca di parole chiave e consigli | Consenti al token 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. |
Modifica dell'uso consentito
Se hai ottenuto l'approvazione 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 client l'accesso allo strumento.