L'API Search Ads 360 Reporting applica limiti alle operazioni dell'API per garantire il rendimento ottimale del sistema 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 per le 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 per le 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 conteggiato come un'operazione, indipendentemente dal fatto che i risultati vengano trasmessi in streaming tramite SearchAds360Service.SearchStream o suddivisi in pagine 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
Conteggio: 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 ai fini della quota giornaliera di operazioni 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 un messaggio di dimensioni pari a 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, le dimensioni della pagina o utilizzare lo streaming.
Le richieste che violano questa limitazione non genereranno un messaggio SearchAds360Error, ma un errore gRPC 429 Resource Exhausted. Consulta l'elenco dei codici di errore e dei messaggi gRPC.
Richieste paginate
Le richieste paginate (ad esempio quelle che contengono un valore next_page_token valido) non vengono conteggiate ai fini della 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 paginate, come le richieste di ricerca, sono soggette al limite di 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 dell'API
Le richieste rifiutate con un valore SearchAds360Failure vengono comunque conteggiate ai fini della quota di operazioni giornaliere dell'utente.
Le richieste che non vanno a buon fine, ma che non restituiscono un valore SearchAds360Failure, ad esempio a causa di un errore a livello di rete, non vengono 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ò comportare l'errore:
REQUEST_SIZE_LIMIT_EXCEEDED.
Lo stesso messaggio di errore può essere dovuto anche ad altri problemi.
Quando esegui una query in 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.