L'API Search Ads 360 Reporting applica limiti alle operazioni dell'API per garantire prestazioni del sistema ottimali per tutti gli utenti.
Prezzi
L'utilizzo dell'API Search Ads 360 Reporting è incluso nei prezzi complessivi 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 operativi dell'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'unica operazione, indipendentemente dal fatto che i risultati vengano trasmessi tramite SearchAds360Service.SearchStream o pagati 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 sulla quota di operazioni giornaliere 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 dei messaggi di 4 MB.
Le risposte non devono superare questo limite. Ad esempio, una richiesta di ricerca che include molti campi potrebbe generare una risposta di dimensioni superiori a 4 MB. 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, le richieste che contengono un valore next_page_token valido) non vengono conteggiate nella quota di operazioni giornaliere di un utente.
Tuttavia, le richieste di impaginazione che contengono 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 di Page size cannot exceed 10,000 rows e vengono rifiutate se violano questo limite, con l'errore: INVALID_PAGE_SIZE.
Per ulteriori dettagli sull'impaginazione, consulta Sfogliare le pagine dei risultati.
Richieste che restituiscono eccezioni API
Le richieste rifiutate con un elemento
SearchAds360Failure vengono comunque conteggiate nella
quota operativa 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 nella 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 nella richiesta può comportare l'errore:
REQUEST_SIZE_LIMIT_EXCEEDED.
Questo messaggio di errore può essere dovuto anche ad altri problemi.
Quando esegui una query Linguaggio di query di Search Ads 360, 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.