Per recuperare le entità e i dati del report dell'API Google Ads, utilizza uno dei seguenti metodi:
Ecco le distinzioni di alto livello per i due metodi:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| Adatto al codice di produzione | Sì | Sì |
| Servizio | GoogleAdsService |
GoogleAdsService |
| Scenario | Recupero di oggetti e report | Recupero di oggetti e report |
| Risposta | Stream di oggetti GoogleAdsRow |
Pagine di GoogleAdsRow oggetti |
| 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 |
SearchStream rispetto a Search
Mentre Search può inviare più
richieste paginate per scaricare l'intero report, SearchStream invia una singola richiesta e
avvia una connessione persistente con l'API Google Ads indipendentemente dalle dimensioni del report.
Per SearchStream, i pacchetti di dati iniziano a essere scaricati immediatamente con l'intero risultato memorizzato nella cache in un buffer di dati. Il codice può iniziare a leggere i dati memorizzati nel buffer senza dover attendere il completamento dell'intero stream.
Eliminando il tempo di andata e ritorno della rete necessario per richiedere ogni singola
pagina di una risposta Search, a seconda dell'app, SearchStream può offrire
prestazioni migliori rispetto alla paginazione, soprattutto per i report più grandi.
Esempio
Questo esempio esamina un report composto da 100,000 righe. La seguente tabella suddivide le differenze di contabilità tra i due metodi.
| SearchStream | Search | |
|---|---|---|
| Dimensioni pagina | Non applicabile | 10.000 righe per pagina |
| Numero di richieste API | 1 richiesta | 10 richieste |
| Numero di risposte API | 1 stream continuo | 10 risposte |
Fattori di rendimento
Per la maggior parte dei casi d'uso, consigliamo SearchStream rispetto a Search per i seguenti
motivi:
Per i report a pagina singola (meno di 10.000 righe): nessuna differenza di rendimento significativa tra i due metodi.
Per i report su più pagine:
SearchStreamè in genere più veloce perché vengono evitati più round trip e la lettura o la scrittura dalla cache del disco è un fattore meno importante.
Limiti di frequenza
I limiti giornalieri per entrambi i metodi rispettano i limiti standard e i livelli di accesso del token sviluppatore. Una singola query o un singolo report viene conteggiato come un'operazione, indipendentemente dal fatto che il risultato sia paginato o trasmesso in streaming.