Questa pagina è stata tradotta dall'API Cloud Translation.

Limiti e quote API

L'API Google Ads applica limiti alle operazioni 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 da tenere presenti.

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`
Modifica richieste	10.000 operazioni per richiesta	`TOO_MANY_MUTATE_OPERATIONS`
Richieste di servizio di pianificazione	1 QPS	`RESOURCE_EXHAUSTED`
Richieste del servizio di caricamento delle conversioni	2000 conversioni per richiesta	`TOO_MANY_CONVERSIONS_IN_REQUEST`
Richieste di servizio per la fatturazione e il budget dell'account	1 operazione per richiesta di modifica	`TOO_MANY_MUTATE_OPERATIONS`

Limiti giornalieri operativi dell'API

I limiti di utilizzo giornaliero delle API si basano sul numero di operazioni API effettuate per ogni token sviluppatore. Le operazioni API sono la somma totale delle richieste di get e delle operazioni di modifica. I limiti per le operazioni API giornaliere dipendono dal livello di accesso del token sviluppatore. La guida ai livelli di accesso e all'uso consentito illustra i limiti operativi dell'API specifici per ciascun 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 generare richieste e risposte. Per impostazione predefinita, gRPC ha una dimensione dei messaggi 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 potrebbe generare una risposta di dimensioni superiori a 64 MB. Per evitare questo limite, puoi ridurre il numero di campi selezionati, le dimensioni della pagina o utilizzare lo streaming. Per le modifiche, invia meno operazioni per richiesta.

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

Modifica richieste

Oltre a essere conteggiata nella quota operativa giornaliera 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 riportati ulteriori limiti e considerazioni relativi a servizi e tipi di richieste specifici.

Richieste di ricerca

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

Richieste impaginate

Le richieste Impaginate (ad esempio, le richieste che contengono un valore next_page_token valido) non vengono conteggiate nella 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.

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

Per ulteriori dettagli sull'impaginazione, consulta Sfogliare le pagine dei risultati.

Altri tipi di richieste

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

Ecco alcuni esempi di richieste di questo tipo:

Richieste che restituiscono eccezioni API

Le richieste rifiutate con un elemento GoogleAdsFailure vengono comunque conteggiate nella quota operativa giornaliera 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.

Servizi di pianificazione

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

Limitato a 1 richiesta al secondo per ID cliente o token sviluppatore:
Le richieste che violano queste limitazioni vengono rifiutate con l'errore: RESOURCE_EXHAUSTED.
1 QPS viene calcolato come 60 richieste ogni 60 secondi.

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

Oggetto piano per le 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

Massimo 2000 conversioni di chiamata o clic 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

Limitato a 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 modifiche possono essere effettuate 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 di modifica è 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 lo stesso account. Apportare modifiche prima che siano trascorse 12 ore può comportare errori irreversibili che possono essere risolti solo dal rappresentante del tuo account Google Ads.

Inviti ad account cliente

I nuovi utenti possono essere invitati negli account cliente esistenti con CustomerUserAccessService. Poiché questa funzionalità invia email di invito ad altri utenti, potrebbe essere utilizzata in modo improprio e il suo comportamento è limitato:

Gli utenti non possono ricevere più di un invito in attesa per lo stesso account cliente. Se viene inviata 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 alla volta. Se viene inviata una richiesta che causa il superamento di questo valore, questo errore viene restituito: ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED.

Dati utente

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

Per eseguire l'applicazione forzata, viene restituito un errore OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS o UserDataError.TOO_MANY_USER_IDENTIFIERS se un set di dati è più di 20 user_identifiers.UserData

Altri tipi di limiti

Un campo ripetuto, ad esempio un elenco di operazioni, con troppi elementi nella richiesta può comportare l'errore: REQUEST_SIZE_LIMIT_EXCEEDED. Questo 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 eseguendo il deployment di 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.