Sie können die mit
GoogleAdsService.Search abgerufenen Ergebnisse durchblättern, anstatt das gesamte Ergebnis
Set auf einmal herunterzuladen. Eine Übersicht zur Berichterstellung mit der Google Ads API finden Sie in der
Übersicht zur Berichterstellung.
Search gibt feste Seiten mit bis zu 10.000 Zeilen zurück. Das Festlegen von page_size in
SearchGoogleAdsRequest ist veraltet und gibt den
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 das Ergebnis-Set 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 die
Anfrage page_token auf die Antwort next_page_token:
{
"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 wird.
Unsere Clientbibliotheken verarbeiten 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 ab, bis der gesamte Datensatz abgerufen wurde. Wenn Sie REST anstelle von gRPC verwenden, müssen Sie explizit eine Anfrage für jede neue Seite stellen.
Caching und Ablauf von Seitentokens
Die Google Ads API speichert den Datensatz intern im Cache, sodass nachfolgende Seitenanfragen schneller sind als die ursprüngliche Anfrage. Beachten Sie, dass next_page_token-Werte eine begrenzte Lebensdauer (Time-to-Live, TTL) haben und ablaufen, wenn sie nicht innerhalb kurzer Zeit (ca. 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 Daten im Cache genutzt 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 sich die Abfrage unterscheidet und mit demselben Seitentoken gesendet wird, wird ein Fehler zurückgegeben.