Sie können die mit GoogleAdsService.Search abgerufenen Ergebnisse seitenweise durchgehen, anstatt die gesamte Ergebnismenge auf einmal herunterzuladen. Eine Übersicht über die Berichterstellung mit der Google Ads API finden Sie in der Übersicht über die Berichterstellung.
Search gibt feste Seiten mit bis zu 10.000 Zeilen zurück. Das Festlegen von page_size in SearchGoogleAdsRequest ist verworfen und gibt einen RequestError.PAGE_SIZE_NOT_SUPPORTED-Fehler zurück.
Beispielabfrage und Paginierung
Betrachten Sie die folgende Abfrage:
SELECT
ad_group.id,
ad_group_criterion.type,
ad_group_criterion.criterion_id,
ad_group_criterion.keyword.text,
ad_group_criterion.keyword.match_type
FROM ad_group_criterion
WHERE ad_group_criterion.type = KEYWORD
Wenn Ihr Konto 50.000 Keywords enthält, enthält die Ergebnismenge in der ersten Antwort 10.000 GoogleAdsRow-Objekte sowie ein next_page_token.
Wenn Sie die nächsten 10.000 Zeilen abrufen möchten, senden Sie die Anfrage noch einmal, aktualisieren Sie aber das page_token der Anfrage auf das next_page_token der Antwort:
{
"query": "SELECT ad_group.id, ad_group_criterion.type, ad_group_criterion.criterion_id, ad_group_criterion.keyword.text, ad_group_criterion.keyword.match_type FROM ad_group_criterion WHERE ad_group_criterion.type = KEYWORD",
"pageToken": "CN3q9...example_token..."
}
Beachten Sie, dass next_page_token in der Antwort, die den letzten Batch von Zeilen enthält, nicht ausgefüllt ist.
Unsere Clientbibliotheken übernehmen die Paginierung automatisch. Sie müssen nur die Zeilen der Antwort durchlaufen. Wenn alle Zeilen auf der aktuellen Seite zurückgegeben wurden, ruft die Clientbibliothek automatisch eine neue Seite mit Zeilen für Sie ab, bis das gesamte Dataset abgerufen wurde. Wenn Sie REST anstelle von gRPC verwenden, müssen Sie für jede neue Seite explizit eine Anfrage stellen.
Caching und Ablauf von Seiten-Tokens
Die Google Ads API speichert das Dataset intern im Cache, sodass nachfolgende Seitenanfragen schneller als die erste Anfrage sind. Beachten Sie, dass next_page_token-Werte eine begrenzte Gültigkeitsdauer (Time to Live, TTL) haben und ablaufen, wenn sie nicht innerhalb eines kurzen Zeitraums (etwa zwei Stunden) verwendet werden. Wenn ein Seitentoken abläuft, gibt die API einen Fehler zurück und Sie müssen eine neue Abfrage starten.
Ihre Abfrage muss in nachfolgenden Anfragen identisch bleiben, damit die im Cache gespeicherten Daten verwendet werden können. Nachfolgende Seitenanfragen werden nicht als zusätzliche Vorgänge auf Ihr tägliches Vorgangskontingent für den Explorer-Zugriff und den grundlegenden Zugriff angerechnet. Wenn die Abfrage abweicht und mit demselben Seitentoken gesendet wird, wird ein Fehler zurückgegeben.