Streaming mit GoogleAdsService melden

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

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 SearchStream in 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.