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 | |||
---|---|---|---|
Richieste impaginate | 10.000 righe per pagina |
INVALID_PAGE_SIZE
|
|
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 API effettuate 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 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 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, 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.
Richieste di modifica
Oltre al conteggio della 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 riportati ulteriori limiti e considerazioni per servizi e tipi di richieste specifici.
Richieste di ricerca
Una richiesta Search
o SearchStream
viene conteggiata come un'operazione rispetto alla quota di operazioni giornaliera dell'utente. Una richiesta SearchStream
viene conteggiata come un'operazione API
indipendentemente dal numero di batch.
Richieste impaginate
Le richieste impaginate (ad esempio, richieste che contengono un next_page_token
valido) non vengono conteggiate nella quota di operazioni giornaliere di un utente.
Tuttavia, le richieste di impaginazione contenenti 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 Page size cannot exceed 10,000 rows
e vengono rifiutate se violano questo limite, con l'errore: INVALID_PAGE_SIZE
.
Per maggiori dettagli sull'impaginazione, consulta la pagina relativa alla visualizzazione dei risultati.
Altri tipi di richieste
Una richiesta diversa da una richiesta Get
, Mutate
, Search
o SearchStream
viene conteggiata come un'operazione rispetto alla quota di operazioni giornaliere dell'utente.
Ecco alcuni esempi di richieste di questo tipo:
BatchJobService.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
Richieste che restituiscono eccezioni API
Le richieste rifiutate con un valore GoogleAdsFailure
vengono comunque conteggiate nella quota di operazioni giornaliere dell'utente.
Le richieste che non vanno a buon fine ma che non restituiscono un
GoogleAdsFailure
, ad esempio un errore a
livello di rete, non verranno 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 metodi di servizio di pianificazione elencati di seguito sono soggetti a limiti distinti rispetto ad altri tipi di richieste.
Con un limite di 1 richiesta al secondo per ID cliente o token sviluppatore:
KeywordPlanService.GetKeywordPlan
KeywordPlanService.GenerateHistoricalMetrics
KeywordPlanService.GenerateForecastMetrics
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 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:
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:
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 e l'altra di un ordine budget nello stesso account. Se apporti modifiche prima che siano trascorse 12 ore, potrebbero verificarsi errori irreversibili, che possono essere risolti solo dal rappresentante del tuo account Google Ads.
Inviti ad account cliente
È possibile invitare nuovi utenti ad account cliente esistenti con CustomerUserAccessService
. Poiché
questa funzionalità invia email di invito ad altri utenti, potrebbe essere
utilizzata in modo improprio, il cui comportamento potrebbe essere limitato:
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 alla volta. 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/rimozione UserData
, ogni
insieme di user_identifiers
deve essere specifico per un singolo utente.
A questo scopo, 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 insieme UserData
.
Altri tipi di limiti
Un campo ripetuto, ad esempio un elenco di operazioni, con 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 eseguendo il deployment di un elenco di 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, viene restituito un errore FILTER_HAS_TOO_MANY_VALUES
.