L'API Search Ads 360 Reporting applica limiti alle operazioni dell'API per garantire prestazioni ottimali del sistema 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 sulle query eseguite con 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 di operazioni dell'API
I limiti di utilizzo giornaliero dell'API si basano sul numero di operazioni API eseguite per progetto Google Cloud.
Una singola query o un singolo report viene conteggiata come un'operazione, indipendentemente dal fatto che i risultati
vengano trasmessi tramite
SearchAds360Service.SearchStream
o trasmessi da una chiamata
SearchAds360Service.Search.
Scopri di più.
La seguente tabella fornisce alcuni esempi di contabilità:
| Richiesta API | Operazioni conteggiate ai fini del limite giornaliero |
|---|---|
Operazione: Search
Numero: 53 gruppi di annunci
Servizio: |
1 |
Operazione: SearchStream
Numero: 45 campagne
Servizio: |
1 |
Le richieste che violano questi limiti vengono rifiutate con l'errore:
RESOURCE_EXHAUSTED.
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.
Limitazioni 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 del messaggio di 4 MB.
Le risposte non devono superare questo limite. Ad esempio, una richiesta di ricerca che include molti campi può generare una risposta che supera i 4 MB di dimensione. Per evitare questo limite, puoi ridurre il numero di campi selezionati, le dimensioni della pagina o utilizzare lo streaming.
Le richieste che violano questa limitazione non genereranno un SearchAds360Error, ma un errore gRPC 429 Resource Exhausted. Fai riferimento all'elenco di codici e messaggi di errore gRPC.
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.
Richieste che restituiscono eccezioni API
Le richieste rifiutate con un valore SearchAds360Failure vengono comunque conteggiate nella quota di operazioni giornaliere dell'utente.
Le richieste che non vanno a buon fine ma che non restituiscono un
SearchAds360Failure, 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.
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.
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 errore FILTER_HAS_TOO_MANY_VALUES.