Per recuperare le entità e i dati dei report dell'API Google Ads, puoi utilizzare uno di questi metodi:
Ecco le differenze generali 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 GoogleAdsRow oggetti |
Pagine di oggetti GoogleAdsRow |
Campi della risposta | Solo quelli specificati nella query | Solo quelli specificati nella query |
Limiti giornalieri | Limiti giornalieri basati sui livelli di accesso | Limiti giornalieri basati sui livelli di accesso |
Confronto tra Searchstream 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 con l'intero risultato memorizzato nella cache in un buffer dei dati. Il codice può iniziare a leggere i dati nel buffer
senza dover attendere il termine dell'intero flusso.
Eliminando il tempo di rete di andata e ritorno necessario per richiedere ogni singola pagina di una risposta Search
, a seconda della tua app, SearchStream
può offrire prestazioni migliori rispetto al paging, soprattutto per i report di dimensioni maggiori.
Esempio
Ad esempio, analizza un report composto da 100,000
righe. La seguente tabella suddivide le differenze contabili 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 prestazioni
Per la maggior parte dei casi d'uso, consigliamo SearchStream
su Search
per i seguenti
motivi:
Per i report a pagina singola (meno di 10.000 righe): non esistono differenze significative in termini di rendimento tra i due metodi.
Per più report di pagine:
SearchStream
è in genere più veloce perché consente di evitare 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 e i livelli di accesso standard del token sviluppatore. Una singola query o un singolo report viene conteggiato come un'unica operazione, indipendentemente dal fatto che il risultato sia impaginato o trasmesso in streaming.