Per discutere e fornire feedback sui nostri prodotti, unisciti al canale Discord ufficiale di Google Ads nel server della community di Google Advertising and Measurement.

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 seguente tabella riepiloga alcuni dei limiti e delle quote importanti da tenere presenti.

Tipo di richiesta, limitazione e codice di errore
Operazioni con il livello di 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 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 assistenza per fatturazione e servizio di budget dell'account	1 operazione per richiesta di modifica	`TOO_MANY_MUTATE_OPERATIONS`

Limiti giornalieri delle operazioni API

I limiti di utilizzo giornalieri dell'API si basano sul numero di operazioni API effettuate per token sviluppatore. Le operazioni API sono la somma totale delle richieste di recupero e delle operazioni di mutazione. I limiti per le operazioni API giornaliere dipendono dal livello di accesso del token sviluppatore. La guida ai livelli di accesso e all'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 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 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. Consulta l'elenco dei codici e dei messaggi di errore gRPC.

Richieste di modifica

Oltre a essere conteggiata ai fini della quota giornaliera di operazioni 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 limiti e considerazioni aggiuntivi per servizi e tipi di richieste specifici.

Cerca richieste

Una richiesta Search o SearchStream conta come un'operazione rispetto alla 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 ai fini della 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 maggiori dettagli sulla paginazione, consulta Scorrere i risultati.

Altri tipi di richieste

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

Ecco alcuni esempi di queste richieste:

Richieste che restituiscono eccezioni API

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

Le richieste non riuscite che non restituiscono un GoogleAdsFailure, ad esempio a causa di un errore a livello di rete, non verranno conteggiate ai fini della quota di operazioni giornaliere dell'utente in quanto le richieste non raggiungeranno mai il servizio. Un esempio è un errore di connettività di rete.

Servizio di pianificazione delle parole chiave

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

Limitato a 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 delle 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 dei metodi AudienceInsightsService sono soggetti a limiti di quota specifici.

Limitato a circa 200 richieste al giorno per ID cliente:
- AudienceInsightsService.generateAudienceCompositionInsights
- AudienceInsightsService.generateSuggestedTargetingInsights
Limitato a 2 richieste al secondo per token sviluppatore:
- AudienceInsightsService.generateTargetingSuggestionMetrics

Servizio di caricamento delle conversioni

Limitato a 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

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 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.
Per le richieste di modifica è consentita una sola 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 di budget e l'altra per lo stesso account. L'apporto di modifiche prima che siano trascorse 12 ore potrebbe comportare errori irrecuperabili che possono essere risolti solo dal rappresentante del tuo account Google Ads.

Inviti agli account cliente

I nuovi utenti possono essere invitati in account cliente esistenti con il CustomerUserAccessService. Poiché questa funzionalità invia email di invito ad altri utenti, ha il potenziale di essere utilizzata in modo improprio, pertanto 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 restituito 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 di 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 quando sono presenti più di 20 user_identifiers in un set UserData.

Sono consentiti fino a 100.000 identificatori utente,indipendentemente dal numero di operazioni.

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.