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 i limiti e le quote importanti di cui tenere conto.
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 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, ridurre dimensioni o utilizzare lo streaming. Per le modifiche, invia meno operazioni per richiesta.
Le richieste che violano questa limitazione non generano un
GoogleAdsError
, ma genererà un'immagine
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 descritti 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 giornaliera.
Anche le richieste impaginate, come le richieste di ricerca, sono soggette alle
Page size cannot exceed 10,000 rows
limitazione e vengono rifiutate se violano
questo limite, con l'errore:
INVALID_PAGE_SIZE
.
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:
BatchJobService.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
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 metodi del servizio Planning elencati di seguito sono soggetti a limiti separati rispetto ad altri tipi di richieste.
Massimo 1 richiesta al secondo per ID cliente:
KeywordPlanIdeaService.GenerateKeywordIdeas
KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
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:
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 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 funzionalità 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/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
.