Limiti e quote API

L'API Google Ads applica limiti alle operazioni dell'API, ad esempio il numero di operazioni che possono essere inviate in una singola richiesta di modifica. La tabella seguente riassume alcuni dei i limiti e le quote importanti di cui tenere conto.

Tipo di richiesta, limitazione e codice di errore
Richieste impaginate 10.000 righe per pagina INVALID_PAGE_SIZE
Operazioni con accesso di base 15.000 operazioni API al giorno RESOURCE_EXHAUSTED
Richieste di modifica 10.000 operazioni per richiesta TOO_MANY_MUTATE_OPERATIONS
Richieste di Planning Service 1 QPS RESOURCE_EXHAUSTED
Richieste di servizio di caricamento delle conversioni 2000 conversioni per richiesta TOO_MANY_CONVERSIONS_IN_REQUEST
Richieste di fatturazione e di servizio del budget dell'account 1 operazione per richiesta di modifica TOO_MANY_MUTATE_OPERATIONS

Limiti giornalieri di operazioni dell'API

I limiti di utilizzo giornaliero dell'API si basano sul numero di operazioni eseguite per token sviluppatore. API operazioni corrispondono alla somma totale delle richieste get e delle operazioni di mutazione. I limiti per le operazioni API quotidiane dipende dal livello di accesso del token sviluppatore. La La guida Livelli di accesso e utilizzo consentito illustra le limiti specifici per ogni livello di accesso.

Le richieste che violano questi limiti vengono rifiutate con l'errore: RESOURCE_EXHAUSTED.

Limitazioni gRPC

Tutte le librerie client dell'API Google Ads utilizzano gRPC per la generazione di richieste e risposte. Per impostazione predefinita, gRPC un messaggio di 4 MB, ma le nostre librerie client impostano la dimensione massima del messaggio su 64 MB per aumentare l'efficienza.

Le risposte non devono superare questo limite. Ad esempio, una richiesta di ricerca che contiene molti campi, può generare una risposta di dimensioni superiori a 64 MB. A evitare questo limite, puoi ridurre il numero di campi selezionati, ridurre dimensioni o utilizzare lo streaming. Per le modifiche, invia meno operazioni per richiesta.

Le richieste che violano questa limitazione non generano un GoogleAdsError, ma genererà un'immagine Errore gRPC 429 Resource Exhausted. Fai riferimento all'elenco di codici di errore gRPC e messaggi.

Richieste di modifica

Oltre a essere conteggiato rispetto alla quota di operazioni giornaliere dell'utente, una modifica non può contenere più di 10.000 operazioni per richiesta.

Le richieste che violano questa limitazione vengono rifiutate con l'errore: TOO_MANY_MUTATE_OPERATIONS.

Ulteriori limiti e considerazioni per servizi e tipi di richieste specifici sono descritti di seguito.

Richieste di ricerca

Una richiesta Search o SearchStream viene conteggiata come un'operazione rispetto alla richiesta della quota massima di operazioni giornaliera. Una richiesta SearchStream viene conteggiata come un'operazione API a prescindere dal numero di batch.

Richieste impaginate

Richieste impaginate (ad esempio, richieste che contengono un indirizzo next_page_token) non vengono conteggiate ai fini della quota di operazioni giornaliera di un utente. Tuttavia, le richieste di impaginazione contenenti un token di pagina scaduto o non valido genera un'eccezione e incide sulla quota di operazioni giornaliera.

Anche le richieste impaginate, come le richieste di ricerca, sono soggette alle Page size cannot exceed 10,000 rows limitazione e vengono rifiutate se violano questo limite, con l'errore: INVALID_PAGE_SIZE.

Per maggiori dettagli sull'impaginazione, consulta la sezione Passaggio alla pagina personalizzati.

Altri tipi di richieste

Una richiesta che non sia una richiesta Get, Mutate, Search o SearchStream vengono conteggiate come un'operazione rispetto alla quota di operazioni giornaliere dell'utente.

Ecco alcuni esempi di richieste di questo tipo:

Richieste che restituiscono eccezioni API

Richieste rifiutate con un GoogleAdsFailure continua a essere conteggiato ai fini del della quota massima di operazioni giornaliere dell'utente.

Richieste che non vanno a buon fine ma che non restituiscono un GoogleAdsFailure, ad esempio a causa di un errore in a livello di rete, non vengono conteggiate nella quota di operazioni giornaliere dell'utente poiché le richieste non raggiungeranno mai il servizio. Un esempio è un errore di connettività di rete.

Servizi di pianificazione

A causa dei costi e della complessità, i metodi del servizio Planning elencati di seguito sono soggetti a limiti separati rispetto ad altri tipi di richieste.

Tieni presente questi limiti quando crei un piano per le parole chiave.

Oggetto piano parole chiave Numero massimo
KeywordPlan per account 10.000
KeywordPlanAdGroup per KeywordPlan 200
KeywordPlanAdGroupKeyword per KeywordPlan 10.000
KeywordPlanCampaignKeyword (parole chiave escluse) 1000
KeywordPlanCampaign per KeywordPlan 1

Servizio di caricamento delle conversioni

Servizio di caricamento degli aggiustamenti delle conversioni

Servizi di fatturazione e budget dell'account

  • Le modifiche possono essere apportate solo per gli account configurati per la fatturazione mensile.

    Le richieste che violano questa limitazione vengono rifiutate con l'errore: MUTATE_NOT_ALLOWED.

  • Per le richieste Mutazione è consentita solo 1 operazione.

    Le richieste che violano questa limitazione vengono rifiutate con l'errore: TOO_MANY_MUTATE_OPERATIONS.

  • Devi attendere almeno 12 ore tra una modifica dell'ordine budget e l'altra lo stesso account. Se apporti modifiche prima che siano trascorse 12 ore, è possibile che Errori irreversibili che possono essere risolti solo dal tuo account Google Ads responsabile.

Inviti ad account cliente

È possibile invitare nuovi utenti ad account cliente esistenti con CustomerUserAccessService. Poiché questa funzionalità invia email di invito ad altri utenti, può a un uso improprio, il che comporta una limitazione:

Dati utente

I dati utente vengono gestiti con UserDataService e OfflineUserDataJobService. In una determinata operazione di creazione/rimozione UserData, ogni insieme di user_identifiers devono essere specifiche di un singolo utente.

Per farlo, un OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS o UserDataError.TOO_MANY_USER_IDENTIFIERS viene restituito un errore quando ci sono più di 20 user_identifiers in un UserData impostato.

Altri tipi di limiti

Un campo ripetuto, ad esempio un elenco di operazioni, con troppi elementi in un può generare l'errore: REQUEST_SIZE_LIMIT_EXCEEDED. Lo stesso messaggio di errore può essere dovuto anche ad altri problemi.

Se riscontri questa limitazione e stai effettuando richieste che utilizzano un prompt ripetuto prova a ridurre il numero di elementi nel campo ripetuto eseguendo il deployment delle operazioni in una richiesta di modifica.

Quando esegui una query GAQL, il numero massimo di elementi in una clausola IN è 20.000. Se superi questo limite, FILTER_HAS_TOO_MANY_VALUES .

Indietro
Panoramica
Avanti
Limiti del sistema