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.