Report Streaming utilizzando GoogleAdsService

Per recuperare le entità e i dati dei report dell'API Google Ads, puoi utilizzare uno dei seguenti metodi:

Di seguito sono riportate le principali differenze tra i due metodi:

GoogleAdsService.SearchStream GoogleAdsService.Search
Adatto per codice di produzione Yes Yes
Servizio GoogleAdsService GoogleAdsService
Scenario Recupero di oggetti e report Recupero di oggetti e report
Risposta Flusso di oggetti GoogleAdsRow Pagine di oggetti GoogleAdsRow
Campi della risposta Solo quelli specificati nella query Solo quelli specificati nella query
Limiti giornalieri Limiti giornalieri in base ai livelli di accesso Limiti giornalieri in base ai livelli di accesso

Mentre Search può inviare più richieste suddivise in pagine per scaricare l'intero report, SearchStream invia una singola richiesta e avvia una connessione permanente con l'API Google Ads, indipendentemente dalle dimensioni del report.

Per SearchStream, il download dei pacchetti di dati inizia immediatamente e l'intero risultato viene memorizzato nella cache in un buffer. Il codice può iniziare a leggere i dati presenti nel buffer senza dover attendere il completamento dell'intero flusso.

Eliminando il tempo di round trip necessario per richiedere ogni singola pagina di una risposta Search, a seconda dell'app, SearchStream può offrire prestazioni migliori rispetto al paging, in particolare per i report di dimensioni maggiori.

Esempio

Prendi, ad esempio, un report composto da 100,000 righe. La tabella seguente illustra le differenze di contabilità tra i due metodi.

SearchStream Cerca
Dimensioni pagina Non applicabile 10.000 righe per pagina
Numero di richieste API 1 richiesta 10 richieste
Numero di risposte dell'API 1 stream continuo 10 risposte

Fattori di rendimento

Per la maggior parte dei casi d'uso, consigliamo di utilizzare SearchStream anziché Search per i seguenti motivi:

  • Per i report di una sola pagina (meno di 10.000 righe): nessuna differenza significativa in termini di prestazioni tra i due metodi.

  • Per i report di più pagine: SearchStream è in genere più veloce perché vengono evitati più andati e quindi la lettura o la scrittura dalla cache su disco è un fattore meno importante.

Limiti di frequenza

I limiti giornalieri per entrambi i metodi rispettano i limiti e i livelli di accesso standard del tuo token sviluppatore. Una singola query o un singolo report viene conteggiata come un'unica operazione, indipendentemente dal fatto che il risultato venga impaginato o trasmesso in streaming.