Zum Abrufen von Google Ads API-Entitäten und Berichtsdaten können Sie eine der folgenden Methoden verwenden:
Im Folgenden finden Sie die wichtigsten Unterschiede zwischen den beiden Methoden:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| Geeignet für Produktionscode | Yes | Yes |
| Dienst | GoogleAdsService |
GoogleAdsService |
| Szenario | Objekte und Berichte werden abgerufen | Objekte und Berichte werden abgerufen |
| Antwort | Stream von GoogleAdsRow-Objekten |
Seiten von GoogleAdsRow-Objekten |
| Antwortfelder | Nur die in der Abfrage angegebenen | Nur die in der Abfrage angegebenen |
| Tageslimits | Tageslimits auf Grundlage von Zugriffsebenen | Tageslimits auf Grundlage von Zugriffsebenen |
SearchStream und Suche im Vergleich
Mit Search können mehrere paginierte Anfragen gesendet werden, um den gesamten Bericht herunterzuladen. SearchStream hingegen sendet eine einzelne Anfrage und stellt unabhängig von der Berichtsgröße eine dauerhafte Verbindung mit der Google Ads API her.
Bei SearchStream wird der Download von Datenpaketen sofort gestartet, wobei das gesamte Ergebnis in einem Datenpuffer zwischengespeichert wird. Ihr Code kann mit dem Lesen der zwischengespeicherten Daten beginnen, ohne warten zu müssen, bis der gesamte Stream beendet ist.
Da die Netzwerkzeit, die je nach Anwendung erforderlich ist, um jede einzelne Seite einer Search-Antwort anzufordern, eliminiert wird, kann mit SearchStream insbesondere bei größeren Berichten die Leistung im Vergleich zum Seitenwechsel verbessert werden.
Beispiel
Nehmen wir z. B. einen Bericht, der aus 100,000 Zeilen besteht. In der folgenden Tabelle sind die Unterschiede bei der Bilanzierung zwischen den beiden Methoden aufgeführt.
| SearchStream | Suche | |
|---|---|---|
| Seitengröße | Nicht aktiv | 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 aus den folgenden Gründen SearchStream statt Search:
Bei Berichten mit einer Seite (weniger als 10.000 Zeilen): Es gibt keine nennenswerten Leistungsunterschiede zwischen den beiden Methoden.
Bei Berichten mit mehreren Seiten:
SearchStreamist in der Regel schneller, da mehrere Umläufe vermieden werden und das Lesen oder Schreiben aus dem Festplatten-Cache weniger ein Faktor ist.
Ratenbegrenzungen
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, welches Ergebnis angezeigt oder gestreamt wird.