Sie können eine der folgenden Methoden verwenden, um Google Ads API-Entitäten und -Berichtsdaten abzurufen:
Im Folgenden werden die Unterschiede zwischen den beiden Methoden erläutert:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| Geeignet für Produktionscode | Ja | Ja |
| Dienst | GoogleAdsService |
GoogleAdsService |
| Szenario | Objekte und Berichte abrufen | Objekte und Berichte abrufen |
| Antwort | Stream von GoogleAdsRow-Objekten |
Seiten von GoogleAdsRow-Objekten |
| Felder der Antwort | Nur die in der Abfrage angegebenen Elemente | Nur die in der Abfrage angegebenen Elemente |
| Tageslimits | Tageslimits basierend auf Zugriffsebenen | Tageslimits basierend auf Zugriffsebenen |
SearchStream und Suche im Vergleich
Während Search mehrere Anfragen mit Seitenzahlen senden kann, um den gesamten Bericht herunterzuladen, sendet SearchStream eine einzelne Anfrage und initiiert unabhängig von der Berichtsgröße eine dauerhafte Verbindung zur Google Ads API.
Bei SearchStream werden Datenpakete sofort heruntergeladen, wobei das gesamte Ergebnis in einem Datenpuffer im Cache gespeichert wird. Ihr Code kann mit dem Lesen der zwischengespeicherten Daten beginnen, ohne warten zu müssen, bis der gesamte Stream beendet ist.
Da die Umlaufzeit im Netzwerk entfällt, die erforderlich ist, um jede einzelne Seite einer Search-Antwort anzufordern, kann SearchStream eine bessere Leistung gegenüber Paging bieten, insbesondere bei größeren Berichten.
Beispiel
Nehmen wir als Beispiel einen Bericht mit 100,000 Zeilen. In der folgenden Tabelle sind die Unterschiede zwischen den beiden Methoden aufgeführt.
| SearchStream | Suche | |
|---|---|---|
| Seitengröße | Nicht aktiv | 10.000 Zeilen pro Seite |
| Anzahl der API-Anfragen | 1 Anfrage | 10 Anfragen |
| Anzahl der API-Antworten | 1 kontinuierlicher Stream | 10 Antworten |
Leistungsfaktoren
Für die meisten Anwendungsfälle empfehlen wir aus folgenden Gründen SearchStream statt Search:
Bei Berichten über einzelne Seiten (unter 10.000 Zeilen): Keine signifikanten Leistungsunterschiede zwischen den beiden Methoden.
Bei Berichten mit mehreren Seiten gilt:
SearchStreamist in der Regel schneller, da mehrere Roundtrips vermieden werden und das Lesen oder Schreiben aus dem Festplatten-Cache weniger ins Gewicht fällt.
Ratenbegrenzungen
Die Tageslimits für beide Methoden entsprechen den Standardlimits und Zugriffsebenen Ihres Entwicklertokens. Eine einzelne Abfrage oder ein einzelner Bericht wird als ein Vorgang gezählt, unabhängig davon, ob das Ergebnis einer Page oder eines Streams ist.