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. Mit SearchStream wird jedoch eine einzelne Anfrage gesendet und
eine dauerhafte Verbindung zur Google Ads API hergestellt, unabhängig von der Berichtsgröße.
Bei SearchStream werden Datenpakete sofort heruntergeladen und das gesamte Ergebnis 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 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 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
Für die meisten Anwendungsfälle empfehlen wir SearchStream anstelle von Search aus folgenden
Gründen:
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 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.