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 |
Confronto tra stream di ricerca e rete di ricerca
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.