In Ergebnissen suchen

GoogleAdsService.Search unterstützt Paging in festen Seitengrößen von 10.000 Zeilen. Die Ergebnismenge der Abfrage wird aufgeteilt. in mehrere Antworten mit jeweils 10.000 Objekten.

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, umfasst die Ergebnismenge 10.000 Keywords. GoogleAdsRow-Objekte in der ersten Antwort, zusammen mit einem next_page_token-Zeichen.

Um die nächsten 10.000 Zeilen abzurufen, senden Sie die Anfrage erneut, aber aktualisieren Sie page_token der Anfrage zu den next_page_token Hinweis: next_page_token in der Antwort, die den letzten Batch von Zeilen enthält, nicht ausgefüllt wird.

Unsere Clientbibliotheken führen Paging automatisch durch. Sie müssen nur durch die Zeilen der Antwort. Wenn alle Zeilen auf der aktuellen Seite zurückgegeben wird, ruft die Client-Bibliothek automatisch bis das gesamte Dataset abgerufen ist. Bei Verwendung von REST von gRPC 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 erste.

Ihre Abfrage muss bei nachfolgenden Anfragen genau gleich bleiben, um der Daten im Cache werden die Anfragen nicht auf Ihr Kontingent angerechnet, insbesondere für den Basiszugriff. Wenn die sich unterscheidet und mit demselben Seitentoken gesendet wird, wird ein Fehler zurückgegeben.