Verwenden Sie eine der folgenden Methoden, um 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 Anfrage angegebenen | Nur die in der Anfrage angegebenen |
| Tageslimits | Tageslimits basierend auf Zugriffsebenen | Tageslimits basierend auf Zugriffsebenen |
SearchStream im Vergleich zu Search
Während Search mehrere paginierte Anfragen senden kann, um den gesamten Bericht herunterzuladen, sendet SearchStream 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 gepufferten Daten beginnen, ohne auf das Ende des gesamten Streams warten zu müssen.
Da die Roundtrip-Netzwerkzeit entfällt, die zum Anfordern jeder einzelnen Seite einer Search-Antwort erforderlich ist, 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 Abrechnungsunterschiede 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 durchgehender Stream | 10 Antworten |
Leistungsfaktoren
Für die meisten Anwendungsfälle empfehlen wir SearchStream aus den folgenden Gründen gegenüber Search:
Berichte mit einer Seite (weniger als 10.000 Zeilen): Zwischen den beiden Methoden gibt es keine signifikanten Leistungsunterschiede.
Bei Berichten mit mehreren Seiten ist
SearchStreamin der Regel schneller, da mehrere Roundtrips vermieden werden und das Lesen oder Schreiben aus dem Festplattencache 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 paginiert oder gestreamt wird.