Abfrageergebnisse paginieren

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 zurückzugebenden Seite. Wenn nicht angegeben, wird die erste Seite zurückgegeben.
  • nextPageToken: Der pageToken-Wert zum Abrufen der nächsten Seite aus einem accounts.reports.search-Aufruf.

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 Anfrage 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 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 ist ein Beispiel für eine Antwort (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 pageToken der Anfrage auf den nextPageToken aus der vorherigen Antwort.

Zurück
Use Merchant Center Query Language