Ergebnisse ansehen

Sie können die mit GoogleAdsService.Search abgerufenen Ergebnisse seitenweise durchgehen, anstatt das gesamte Ergebnis-Set auf einmal herunterzuladen. Eine Übersicht zur Berichterstellung mit der Google Ads API finden Sie im Leitfaden zur Berichterstellung.

Die Ergebnisse werden auf Seiten mit bis zu 10.000 Zeilen zurückgegeben. Wenn page_size in der Anfrage nicht festgelegt ist, wird standardmäßig 10.000 verwendet. Wenn page_size auf einen Wert über 10.000 festgelegt ist, wird trotzdem 10.000 verwendet.

Betrachten Sie beispielsweise 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, enthält das Ergebnis-Set 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 das page_token der Anfrage auf dasnext_page_token der Antwort. Note that next_page_token wird in der Antwort, die den letzten Batch von Zeilen enthält, nicht ausgefüllt.

Unsere Clientbibliotheken verarbeiten die Paginierung automatisch. Sie müssen nur die Zeilen der Antwort durchgehen. Wenn alle Zeilen auf der aktuellen Seite zurückgegeben wurden, ruft die Clientbibliothek automatisch eine neue Seite mit Zeilen für Sie ab, bis das gesamte Dataset abgerufen wurde. Wenn Sie REST anstelle von gRPC verwenden, müssen Sie für jede neue Seite explizit eine Anfrage senden.

Die Google Ads API speichert das gesamte Dataset intern im Cache. Nachfolgende Anfragen sind daher schneller als die erste.

Ihre Abfrage muss in nachfolgenden Anfragen genau gleich bleiben, damit die Daten aus dem Cache verwendet werden können. Die Anfragen werden nicht auf Ihr Kontingent angerechnet, insbesondere nicht für die Zugriffsebenen „Explorer“ und „Grundlegend“. Wenn sich die Abfrage unterscheidet und mit demselben Seitentoken gesendet wird, wird ein Fehler zurückgegeben.