Paginate query results

Die Merchant Center Query Language bietet die folgenden Felder für die Paginierung:

  • pageSize: Die maximale Anzahl der Zeilen, die in einer einzelnen Anfrage abgerufen werden sollen. Standardmäßig wird die maximale Seitengröße von 1.000 Zeilen verwendet.
  • pageToken: Das Token der zurückzugebenden Seite. Bei keiner Angabe wird die erste Seite zurückgegeben.
  • nextPageToken: Der pageToken-Wert, mit dem die nächste Seite aus einem accounts.reports.search-Aufruf abgerufen wird.

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 ausführen 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 das pageToken der Anfrage auf das nextPageToken aus der vorherigen Antwort.