Questa pagina è stata tradotta dall'API Cloud Translation.

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 limiti e delle quote importanti di cui devi essere a conoscenza.

Tipo di richiesta, limitazione e codice di errore
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 servizi di pianificazione	1 QPS	`RESOURCE_EXHAUSTED`
Richieste di servizio di caricamento delle conversioni	2000 conversioni per richiesta	`TOO_MANY_CONVERSIONS_IN_REQUEST`
Richieste di servizi di fatturazione e budget dell'account	1 operazione per richiesta di modifica	`TOO_MANY_MUTATE_OPERATIONS`

Limiti giornalieri per le operazioni dell'API

I limiti di utilizzo giornaliero dell'API si basano sul numero di operazioni dell'API effettuate per token sviluppatore. Le operazioni API sono la somma totale delle richieste get e delle operazioni di mutazione. I limiti per le operazioni giornaliere dell'API dipendono dal livello di accesso del token sviluppatore. La guida Livelli di accesso e utilizzo consentito illustra i limiti di operazioni API specifici per ciascun 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 dei messaggi 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 che supera i 64 MB. Per evitare questo limite, puoi ridurre il numero di campi selezionati o utilizzare lo streaming. Per le operazioni di mutazione, invia meno operazioni per richiesta.

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

Richieste di modifica

Oltre a essere conteggiata ai fini della quota di operazioni giornaliere dell'utente, una richiesta con mutazioni 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 illustrati di seguito.

Richieste di ricerca

Una richiesta Search o SearchStream viene conteggiata come un'operazione ai fini della quota giornaliera di operazioni dell'utente. Una richiesta SearchStream viene conteggiata come un'operazione API indipendentemente dal numero di batch.

Richieste impaginate

Le richieste paginate (ad esempio quelle che contengono un valore next_page_token valido) non vengono conteggiate ai fini della quota di operazioni giornaliere di un utente. Tuttavia, le richieste di impaginazione 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 Eseguire la paginazione dei risultati.

Altri tipi di richieste

Una richiesta diversa da Get, Mutate, Search o SearchStream viene conteggiata come un'operazione ai fini della quota giornaliera di operazioni dell'utente.

Ecco alcuni esempi di richieste di questo tipo:

Richieste che restituiscono eccezioni dell'API

Le richieste rifiutate con un valore GoogleAdsFailure vengono comunque conteggiate ai fini della quota di operazioni giornaliere dell'utente.

Le richieste che non vanno a buon fine, ma che non restituiscono un valore GoogleAdsFailure, ad esempio a causa di un errore a livello di rete, non vengono conteggiate ai fini della 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 seguenti metodi di servizio di Planning sono soggetti a limiti distinti rispetto ad altri tipi di richieste.

Limite di 1 richiesta al secondo per ID cliente:
Le richieste che violano queste limitazioni vengono rifiutate con l'errore: RESOURCE_EXHAUSTED.
1 QPS viene calcolato come 60 richieste ogni 60 secondi.
Limitato a 2 richieste al secondo per ID cliente:
- KeywordPlanIdeaService.GenerateAdGroupTheme

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 di caricamento delle conversioni

Limite di 2000 conversioni di clic o chiamate per richiesta:
- ConversionUploadService.UploadCallConversions
- ConversionUploadService.UploadClickConversions
Le richieste che violano questi limiti vengono rifiutate con l'errore: TOO_MANY_CONVERSIONS_IN_REQUEST.

Servizio di caricamento degli aggiustamenti delle conversioni

Limite di 2000 aggiustamenti delle conversioni per richiesta:
- ConversionAdjustmentUploadService.UploadConversionAdjustments
Le richieste che violano questi limiti vengono rifiutate con l'errore: TOO_MANY_ADJUSTMENTS_IN_REQUEST.

Servizi di fatturazione e budget dell'account

Le mutazioni 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.
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 del budget e l'altra nello 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 CustomerUserAccessService. Poiché questa funzionalità invia email di invito ad altri utenti, potrebbe essere usata in modo improprio e, di conseguenza, il suo comportamento è soggetto a limitazioni:

Gli utenti non possono ricevere più di un invito in attesa per lo stesso account cliente. Se viene effettuata una richiesta successiva per inviare un invito a un utente che ha già un invito in attesa, viene restituito questo errore: ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION.
Gli account cliente non possono avere più di 70 inviti in attesa contemporaneamente. Se viene inviata una richiesta che causa il superamento di questo valore, viene visualizzato questo errore: ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED.

Dati utente

I dati utente vengono gestiti con UserDataService e OfflineUserDataJobService. In una determinata operazione di creazione o rimozione UserData, ogni insieme di user_identifiers deve essere specifico per un singolo utente.

Per applicare questa regola, viene restituito un errore OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS o UserDataError.TOO_MANY_USER_IDENTIFIERS se in un insieme UserData sono presenti più di 20 user_identifiers.

Altri tipi di limiti

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

Se riscontri questa limitazione e invii 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.