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 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 mehrere
paginierte Anfragen gesendet werden, um den gesamten Bericht herunterzuladen. SearchStream sendet jedoch eine einzelne Anfrage und
initiiert unabhängig von der Berichtsgröße eine dauerhafte Verbindung zur Google Ads API.
Bei SearchStream werden Datenpakete sofort heruntergeladen und das gesamte Ergebnis wird in einem Datenpuffer gespeichert. Ihr Code kann die gepufferten Daten lesen, ohne warten zu müssen, bis der gesamte Stream abgeschlossen ist.
Da die Round-Trip-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 sind die Unterschiede bei der Abrechnung zwischen den beiden Methoden aufgeführt.
| SearchStream | Search | |
|---|---|---|
| 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
In den meisten Anwendungsfällen empfehlen wir SearchStream aus folgenden
Gründen gegenüber Search:
Bei Berichten mit einer Seite (weniger als 10.000 Zeilen): Es gibt keine signifikanten Leistungsunterschiede zwischen den beiden Methoden.
Bei Berichten mit mehreren Seiten:
SearchStreamist in der Regel schneller, da mehrere Round-Trips vermieden werden und das Lesen oder Schreiben aus dem Datenträger-Cache eine geringere Rolle spielt.
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.