Sie haben folgende Möglichkeiten, Google Ads API-Entitäten und Berichtsdaten abzurufen:
Hier sind die wichtigsten Unterschiede zwischen den beiden Methoden:
| 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 | Nur die in der Abfrage angegebenen |
| Tageslimits | Tageslimits basierend auf Zugriffsebenen | Tageslimits basierend auf Zugriffsebenen |
SearchStream im Vergleich zu Search
Mit Search können Sie mehrere paginaierte Anfragen senden, um den gesamten Bericht herunterzuladen. SearchStream sendet dagegen eine einzelne Anfrage und stellt unabhängig von der Berichtsgröße eine dauerhafte Verbindung zur Google Ads API her.
Bei SearchStream werden Datenpakete sofort heruntergeladen und das gesamte Ergebnis wird in einem Datenpuffer zwischengespeichert. Ihr Code kann mit dem Lesen der zwischengespeicherten Daten beginnen, ohne auf das Ende des gesamten Streams warten zu müssen.
Da die Netzwerklaufzeit für die Anforderung jeder einzelnen Seite einer Search-Antwort entfällt, kann SearchStream je nach App eine bessere Leistung als die Paginierung bieten, insbesondere bei größeren Berichten.
Beispiel
In diesem Beispiel wird ein Bericht mit 100,000 Zeilen betrachtet. In der folgenden Tabelle werden die Unterschiede bei der Abrechnung zwischen den beiden Methoden aufgeschlüsselt.
| SearchStream | Suchen | |
|---|---|---|
| Seitengröße | Nicht zutreffend | 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 SearchStream anstelle von Search aus den folgenden Gründen:
Für Berichte auf einer Seite (weniger als 10.000 Zeilen): Keine signifikanten Leistungsunterschiede zwischen den beiden Methoden.
Bei Berichten mit mehreren Seiten:
SearchStreamist in der Regel schneller, da mehrere Rücksprünge vermieden werden und das Lesen oder Schreiben aus dem Laufwerkcache weniger ins Gewicht fällt.
Ratenlimits
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 gepuffert oder gestreamt wird.