Paginate query results

Die Merchant Center-Abfragesprache bietet die folgenden Felder für die Paginierung:

  • pageSize: Die maximale Anzahl von Zeilen, die in einer einzelnen Anfrage abgerufen werden sollen. Standardmäßig ist die maximale Seitengröße von 1.000 Zeilen festgelegt.
  • pageToken: Das Token der Seite, die zurückgegeben werden soll. Wenn keine Angabe erfolgt, wird die erste Seite zurückgegeben.
  • nextPageToken: Der pageToken-Wert, um die nächste Seite über einen accounts.reports.search-Aufruf abzurufen.

Wenn ein pageToken angegeben wird, 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 offer_id-Werten stellen und pageSize auf 200 festgelegt ist, enthält das Ergebnis in der ersten Antwort nur 200 ReportRow-Objekte sowie einen nextPageToken:

SELECT offer_id, impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-31'

Hier ist eine Beispielantwort (die ersten fünf Ergebnisse und die 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, aktualisieren Sie aber den Wert für pageToken in der Anfrage auf den Wert für nextPageToken aus der vorherigen Antwort.