Limiti e quote API

L'API Google Ads applica limiti alle operazioni API, ad esempio al numero di operazioni che possono essere inviate in una singola richiesta di modifica. La tabella seguente riassume alcuni dei limiti e delle quote importanti da tenere presenti.

Tipo di richiesta, limitazione e codice di errore
Operazioni con livello di accesso Explorer 2880 operazioni API al giorno per gli account di produzione
15.000 operazioni API al giorno per gli account di test 		RESOURCE_EXHAUSTED
Operazioni con livello di accesso di base 15.000 operazioni API al giorno per gli account di test e di produzione RESOURCE_EXHAUSTED
Richieste di modifica 10.000 operazioni per richiesta TOO_MANY_MUTATE_OPERATIONS
Richieste del servizio di pianificazione 1 QPS RESOURCE_EXHAUSTED
Richieste del servizio di caricamento delle conversioni 2000 conversioni per richiesta TOO_MANY_CONVERSIONS_IN_REQUEST
Richieste dei servizi di fatturazione e budget dell'account 1 operazione per richiesta di modifica TOO_MANY_MUTATE_OPERATIONS

Limiti giornalieri delle operazioni API

I limiti di utilizzo giornaliero dell'API si basano sul numero di operazioni API eseguite per token sviluppatore. Le operazioni API sono la somma totale delle richieste get e delle operazioni di modifica. I limiti per le operazioni API giornaliere dipendono dal livello di accesso del token sviluppatore. La guida Livelli di accesso e utilizzo consentito descrive i limiti specifici delle operazioni API per ogni livello di accesso.

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

Limitazioni di gRPC

Tutte le librerie client dell'API Google Ads utilizzano gRPC per generare richieste e risposte. Per impostazione predefinita, gRPC ha una dimensione del 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 include molti campi può generare una risposta di dimensioni superiori a 64 MB. Per evitare questo limite, puoi ridurre il numero di campi selezionati o utilizzare lo streaming. Per le modifiche, invia meno operazioni per richiesta.

Le richieste che violano questa limitazione non genereranno un GoogleAdsError, ma genereranno un 429 Resource Exhausted gRPC error. Consulta l'elenco dei codici e dei messaggi di errore gRPC.

Richieste di modifica

Oltre a essere conteggiata nella quota di operazioni giornaliere dell'utente, una richiesta di 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.

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

Cerca richieste

Una richiesta Search o SearchStream viene conteggiata come un'operazione nella quota di operazioni giornaliere dell'utente. Una richiesta SearchStream viene conteggiata come un'operazione API, indipendentemente dal numero di batch.

Richieste paginate

Le richieste paginate (ad esempio, le richieste che contengono un next_page_token valido) non vengono conteggiate nella quota di operazioni giornaliere di un utente. Tuttavia, le richieste di paginazione che contengono un token di pagina scaduto o non valido genereranno un'eccezione e verranno conteggiate nella quota di operazioni giornaliere.

Per ulteriori dettagli sulla paginazione, consulta la sezione Paginazione dei risultati.

Altri tipi di richieste

Una richiesta che non è una richiesta Get, Mutate, Search o SearchStream viene conteggiata come un'operazione nella quota di operazioni giornaliere dell'utente.

Ecco alcuni esempi di queste richieste:

Richieste che restituiscono eccezioni API

Le richieste rifiutate con un GoogleAdsFailure vengono comunque conteggiate nella quota di operazioni giornaliere dell'utente.

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

Servizio di pianificazione delle parole chiave

A causa del costo e della complessità, i seguenti metodi del servizio di pianificazione delle parole chiave sono soggetti a limiti separati rispetto ad altri tipi di richieste.

Tieni presente questi limiti quando crei un piano di parole chiave.

Oggetto piano di 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 Statistiche sul pubblico

I seguenti metodi all'interno di AudienceInsightsService sono soggetti a limiti di quota specifici.

Servizio di caricamento delle conversioni

Servizio di caricamento degli aggiustamenti delle conversioni

Regole per i valori di conversione

Se per l'account esiste già un ConversionValueRuleSet con un attachment_type di CUSTOMER, devi aggiungere tutte le nuove regole per i valori di conversione a questo insieme affinché diventino attive. Se non esiste un insieme di regole per i valori di conversione di questo tipo, devi crearne uno e aggiungervi le regole per i valori di conversione come descritto in Creare insiemi di regole.

Servizi di fatturazione e budget dell'account

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

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

  • È consentita solo 1 operazione per le richieste di modifica.

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

  • Devi attendere almeno 12 ore tra le modifiche dell'ordine di budget allo stesso account. Se apporti modifiche prima che siano trascorse 12 ore, potresti riscontrare errori irrecuperabili che possono essere risolti solo dal rappresentante dell'account Google Ads.

Inviti agli account cliente

I nuovi utenti possono essere invitati agli account cliente esistenti con il CustomerUserAccessService. Poiché questa funzionalità invia email di invito ad altri utenti, potrebbe essere utilizzata in modo improprio. Per questo motivo, il suo comportamento è soggetto a limitazioni:

Dati utente

I dati utente vengono gestiti con UserDataService e OfflineUserDataJobService.

Ogni UserData oggetto in un'operazione create o remove si riferisce a un singolo utente finale. Il campo user_identifiers all'interno di un singolo UserData oggetto è limitato a un massimo di 20 identificatori. Se superi questo limite in un singolo UserData oggetto, verrà generato un errore OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS o UserDataError.TOO_MANY_USER_IDENTIFIERS.

Gestire gli utenti con più di 20 identificatori

Se un singolo utente finale possiede più di 20 identificatori che devi caricare, devi distribuirli su più oggetti UserData. Per assicurarti che Google possa associare tutti questi identificatori allo stesso utente finale, ogni oggetto UserData per quell'utente deve includere almeno un user_identifier comune, ad esempio lo stesso hashed_email, hashed_phone_number o third_party_user_id. Google utilizza questi identificatori condivisi per collegare e unire le informazioni delle operazioni UserData separate al profilo utente finale corretto.

Se utilizzi PII come indirizzi email o numeri di telefono sottoposti ad hashing, assicurati che siano normalizzati e sottoposti ad hashing in base ai requisiti dell'API Google Ads (SHA-256, minuscole, senza spazi vuoti) per evitare errori di collegamento.

Ad esempio, se un utente ha 30 indirizzi email, puoi inviare due oggetti UserData.

  • UserData 1: {third_party_user_id: "user123", hashed_email: "email1@...", ... hashed_email: "email19@..."}
  • UserData 2: {third_party_user_id: "user123", hashed_email: "email20@...", ... hashed_email: "email30@..."}

Il limite totale per user_identifiers in tutte le operazioni di un singolo OfflineUserDataJob rimane 100.000.

Altri tipi di limiti

Un campo ripetuto, ad esempio un elenco di operazioni, che contiene troppi elementi in una richiesta 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 campo ripetuto, prova a ridurre il numero di elementi nel campo ripetuto implementando un elenco di operazioni in una richiesta di modifica.

Quando esegui una query GAQL, il numero massimo di elementi all'interno di una clausola IN è 20.000. Se superi questo limite, viene restituito un errore FILTER_HAS_TOO_MANY_VALUES.

Indietro
Panoramica
Avanti
Limiti del sistema