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.