Paginate query results

Im Merchant Center Query Language (Abfragesprache) stehen die folgenden Felder für die Paginierung zur Verfügung:

  • pageSize: Die maximale Anzahl von Zeilen, die in einer einzelnen Anfrage abgerufen werden sollen. Die Standardeinstellung ist die maximale Seitengröße von 1.000 Zeilen.
  • pageToken: Das Token der Seite, die zurückgegeben werden soll. Wenn keine Angabe gemacht wird, wird die erste Seite zurückgegeben.
  • nextPageToken: Der Wert pageToken zum Abrufen der nächsten Seite nach einem accounts.reports.search-Aufruf.

Wenn pageToken angegeben ist, müssen alle anderen Parameter im Aufruf mit dem vorherigen Aufruf übereinstimmen, um unerwartetes Verhalten zu vermeiden.

Wenn Sie beispielsweise die folgende Abfrage für ein Konto mit 100.000 offerId-Werten durchführen und pageSize auf 200 festgelegt ist, enthält das Ergebnis in der ersten Antwort nur 200 ReportRow-Objekte zusammen mit einem nextPageToken:

SELECT offerId, impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2021-12-01' AND '2021-12-31'

Hier ist eine Beispielantwort (die ersten fünf Ergebnisse und das nextPageToken):

{
  "results": [
    {
      "productPerformanceView": {
        "offerId": "12345",
        "clicks": "0",
        "impressions": "59",
        "clickThroughRate": 0
      }
    },
    {
      "productPerformanceView": {
        "offerId": "12346",
        "clicks": "9625",
        "impressions": "276695",
        "clickThroughRate": 0.034785594246372356
      }
    },
    {
      "productPerformanceView": {
        "offerId": "12347",
        "clicks": "148",
        "impressions": "22045",
        "clickThroughRate": 0.0067135404853708325
      }
    },
    {
      "productPerformanceView": {
        "offerId": "12348",
        "clicks": "11",
        "impressions": "1100",
        "clickThroughRate": 0.01
      }
    },
    {
      "productPerformanceView": {
        "offerId": "12349",
        "clicks": "569",
        "impressions": "62977",
        "clickThroughRate": 0.0090350445400701838
      }
    },
    ...
  ],
  "nextPageToken": "CMgB"
}

Wenn Sie die nächsten 200 Zeilen abrufen möchten, senden Sie die Anfrage noch einmal mit derselben Seitengröße. Ändern Sie aber den pageToken der Anfrage auf nextPageToken aus der vorherigen Antwort.