GoogleAdsService.Search unterstützt das Paging durch Angabe von page_size in der Anfrage.
Dadurch wird das Ergebnis der Abfrage in mehrere Antworten aufgeteilt, die jeweils bis zu page_size Objekte enthalten. Wenn page_size nicht angegeben ist, wird er automatisch auf das Maximum von 10.000 Zeilen festgelegt.
Beispiel für 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 und page_size auf 1,000 gesetzt ist, enthält die Ergebnismenge 1.000 GoogleAdsRow-Objekte in der ersten Antwort sowie einen next_page_token-Wert.
Wenn Sie die nächsten 1.000 Zeilen abrufen möchten, senden Sie die Anfrage noch einmal mit derselben Seitengröße, aber aktualisieren Sie den page_token der Anfrage auf den next_page_token der Antwort. Der Wert von page_size in nachfolgenden Anfragen kann jedes Mal unterschiedlich sein. Beachten Sie, dass next_page_token nicht in der Antwort gefüllt wird, die den letzten Batch von Zeilen enthält.
Unsere Clientbibliotheken führen Paging automatisch durch. Sie müssen nur durch die Zeilen der Antwort iterieren. Wenn alle Zeilen auf der aktuellen Seite zurückgegeben wurden, ruft die Clientbibliothek automatisch eine neue Seite mit Zeilen für Sie ab, bis der gesamte Datensatz abgerufen ist. Wenn Sie REST anstelle von gRPC verwenden, müssen Sie für jede neue Seite explizit eine Anfrage stellen.
Die Google Ads API speichert intern den gesamten Datensatz im Cache, sodass nachfolgende Anfragen schneller sind als die ursprüngliche. Je nach Anwendungsfall können Sie für page_size einen beliebigen Wert zwischen 1 und 10.000 festlegen. Im Allgemeinen sollten Sie für weniger Umläufe einen größeren page_size verwenden, um die Gesamtleistung zu verbessern.
Ihre Abfrage muss in nachfolgenden Anfragen genau gleich bleiben, um die im Cache gespeicherten Daten zu nutzen. Die Anfragen werden nicht auf Ihr Kontingent angerechnet, insbesondere beim Basiszugriff. Wenn sich die Abfrage unterscheidet und mit demselben Seitentoken gesendet wird, wird ein Fehler zurückgegeben.