Paginate query results

Merchant Center-Abfrage Sprache bietet Folgendes: für die Paginierung:

  • pageSize: Die maximale Anzahl der Zeilen, die in einer einzelnen Anfrage abgerufen werden sollen. Die Standardeinstellung ist die maximale Seitengröße von 1.000 Zeilen.
  • pageToken: Das Token der zurückzugebenden Seite. Wenn nicht angegeben, wird die erste zurückgegeben wird.
  • nextPageToken: Der pageToken-Wert, mit dem die nächste Seite von einer accounts.reports.search anrufen.

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

Angenommen, Sie stellen die folgende Abfrage für ein Konto mit 100.000 offerId-Werte und pageSize auf 200 gesetzt ist, enthält das Ergebnis nur 200 ReportRow-Objekte in der ersten Antwort 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 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"
}

Um die nächsten 200 Zeilen abzurufen, senden Sie die Anfrage noch einmal mit derselben Seitengröße. pageToken der Anfrage jedoch mit dem nextPageToken aus dem der vorhergehenden Antwort.