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. Der Standardwert ist die maximale Seitengröße von 1.000 Zeilen.
• pageToken: Das Token der Seite, die zurückgegeben werden soll. Wenn nicht angegeben, wird die erste Seite zurückgegeben.
• nextPageToken: Der Wert von pageToken, mit dem die nächste Seite aus einem accounts.reports.search Aufruf abgerufen werden kann.

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 ein nextPageToken:

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

Hier sehen Sie 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. Aktualisieren Sie aber pageToken der Anfrage auf das nextPageToken aus der vorherigen Antwort.