L'API Search Ads 360 Reporting applica limiti alle operazioni API per garantire prestazioni di sistema ottimali per tutti gli utenti.
Prezzi
L'utilizzo dell'API Search Ads 360 Reporting è incluso nel prezzo complessivo di Search Ads 360. Non sono previsti costi aggiuntivi per l'utilizzo dell'API.
Limiti delle query
I seguenti limiti si applicano alle operazioni di query eseguite tramite i metodi Search o SearchStream.
- 3000 query al minuto per progetto per utente
- 3000 query al minuto per progetto
- 150.000 query al giorno per progetto
Limiti giornalieri delle operazioni API
I limiti di utilizzo giornaliero delle API si basano sul numero di operazioni API eseguite per progetto Google Cloud.
Una singola query o un singolo report viene conteggiato come un'operazione, indipendentemente dal fatto che i risultati
vengano trasmessi in streaming tramite
SearchAds360Service.SearchStream
o paginati da una
SearchAds360Service.Search
chiamata. Scopri di più.
La seguente tabella mostra alcuni esempi di contabilità:
| Richiesta API | Operazioni conteggiate ai fini del limite giornaliero |
|---|---|
Operazione: Search
Conteggio: 53 gruppi di annunci Servizio: SearchAds360Service
|
1 |
Operazione: SearchStream
Conteggio: 45 campagne Servizio: SearchAds360Service
|
1 |
Le richieste che violano questi limiti vengono rifiutate con l'errore:
RESOURCE_EXHAUSTED.
Cerca richieste
Una richiesta Search o SearchStream viene conteggiata come un'operazione ai fini della quota di operazioni giornaliera dell'utente. Una richiesta SearchStream viene conteggiata come un'operazione API indipendentemente dal numero di batch.
Limitazioni di gRPC
Tutte le librerie client dell'API Search Ads 360 Reporting utilizzano gRPC per generare richieste e risposte. Per impostazione predefinita, gRPC ha una dimensione dei messaggi di 4 MB.
Le risposte non devono superare questo limite. Ad esempio, una richiesta di ricerca che include molti campi può generare una risposta di dimensioni superiori a 4 MB. Per evitare questo limite, puoi ridurre il numero di campi selezionati, ridurre le dimensioni della pagina o utilizzare lo streaming.
Le richieste che violano questa limitazione non genereranno un
SearchAds360Error,
ma genereranno un errore gRPC 429 Resource Exhausted. Consulta l'
elenco dei codici e dei messaggi di errore gRPC.
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 giornaliera di un utente.
Tuttavia, le richieste di paginazione che contengono un token di pagina scaduto o non valido genereranno un'eccezione e verranno conteggiate ai fini della quota di operazioni giornaliera.
Anche le richieste paginate, come le richieste di ricerca, sono soggette alla
Page size cannot exceed 10,000 rows limitazione e vengono rifiutate se violano
questo limite, con l'errore:
INVALID_PAGE_SIZE.
Per ulteriori dettagli sulla paginazione, consulta la sezione Paginazione dei risultati.
Richieste che restituiscono eccezioni API
Le richieste rifiutate con un
SearchAds360Failure
vengono comunque conteggiate ai fini della quota di operazioni giornaliera dell'utente.
Le richieste che non vanno a buon fine ma non restituiscono un
SearchAds360Failure,
ad esempio a causa di un errore a livello di rete, non verranno conteggiate ai fini della quota di operazioni giornaliera dell'utente,
poiché le richieste non raggiungeranno mai il servizio. Un esempio è un errore di connettività di rete.
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.
Quando si esegue una query Search Ads 360 Query Language,
il numero massimo di elementi all'interno di una clausola IN è 20.000. Se superi questo
limite, viene restituito un
FILTER_HAS_TOO_MANY_VALUES
errore.