GoogleAdsService.Search unterstützt die Paginierung in festen Seitengrößen von 10.000 Zeilen. Die Ergebnismenge der Abfrage wird in mehrere Antworten mit jeweils 10.000 Objekten aufgeteilt.
Beispiel:
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 die page_token der Anfrage auf die next_page_token der Antwort.
Beachten Sie, dass next_page_token in der Antwort, die die letzte Gruppe von Zeilen enthält, nicht ausgefüllt ist.
Die Paginierung wird von unseren Clientbibliotheken automatisch verwaltet. Sie müssen nur die Zeilen der Antwort durchgehen. Wenn alle Zeilen der aktuellen Seite zurückgegeben wurden, ruft die Clientbibliothek automatisch eine neue Seite mit Zeilen in Ihrem Namen ab, bis der gesamte Datensatz abgerufen wurde. Wenn Sie anstelle von gRPC REST verwenden, müssen Sie für jede neue Seite explizit eine Anfrage stellen.
Die Google Ads API speichert den gesamten Datensatz intern im Cache. Daher sind nachfolgende Anfragen schneller als die erste.
Ihre Abfrage muss in nachfolgenden Anfragen genau gleich bleiben, damit die im Cache gespeicherten Daten verwendet werden können. Die Anfragen werden nicht auf Ihr Kontingent angerechnet, insbesondere nicht beim grundlegenden Zugriff. Wenn sich die Abfrage unterscheidet und mit demselben Seitentoken gesendet wird, wird ein Fehler zurückgegeben.