GoogleAdsService.Search unterstützt Paging durch Angabe von page_size in der Anfrage.
Dadurch wird der Ergebnissatz der Abfrage in mehrere Antworten aufgeteilt, von denen jede bis zu page_size Anzahl von Objekten enthält. Wenn page_size nicht angegeben ist, wird er automatisch auf das Maximum von 10.000 Zeilen festgelegt.
Hier ein 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 in der ersten Antwort 1.000 GoogleAdsRow-Objekte und ein next_page_token-Objekt.
Wenn Sie die nächsten 1.000 Zeilen abrufen möchten, senden Sie die Anfrage noch einmal mit derselben Seitengröße. Ändern Sie dabei aber den page_token der Anfrage auf next_page_token der Antwort. Der Wert von page_size in nachfolgenden Anfragen kann jedes Mal anders sein. In der Antwort, die den letzten Batch von Zeilen enthält, ist next_page_token nicht ausgefüllt.
Unsere Clientbibliotheken übernehmen das Paging 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 das gesamte Dataset 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 den gesamten Datensatz intern im Cache, sodass nachfolgende Anfragen schneller als die ursprüngliche sind. 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 eine höhere Gesamtleistung eine größere page_size für weniger Umläufe verwenden.
Die Abfrage muss in nachfolgenden Anfragen exakt gleich bleiben, damit die im Cache gespeicherten Daten genutzt werden können. Die Anfragen werden nicht auf Ihr Kontingent angerechnet, insbesondere nicht für den Basiszugriff. Wenn sich die Abfrage unterscheidet und mit demselben Seitentoken gesendet wird, wird ein Fehler zurückgegeben.