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 seguente tabella 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 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 oppure utilizzare flussi di dati. Per le modifiche, invia meno operazioni per richiesta.

Le richieste che violano questa limitazione non generano un GoogleAdsError, ma genererà un'eccezione 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 come descritto 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 giornaliere.

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 seguenti metodi del servizio di pianificazione sono soggetti a limiti separati rispetto ad altri tipi di richieste.

Massimo 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 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

Con un limite di 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

Con un 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 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 funzione invia email di invito ad altri utenti, può a un uso improprio, il che comporta una limitazione:

Gli utenti non possono ricevere più di un invito in attesa per lo stesso cliente . Se viene effettuata una richiesta successiva per inviare un invito a un utente che ha già un invito in sospeso, 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 o 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 .