Paginate query results

Merchant Center 查詢 語言提供下列內容： 以下欄位：

  • pageSize：單一要求中擷取的資料列數量上限。 預設值為頁面大小上限 (1000 列)。
  • pageToken：要傳回的頁面符記。如果未指定，則第一個 。
  • nextPageToken：pageToken 值，用於從 accounts.reports.search敬上 呼叫。

如果提供 pageToken，則呼叫中的所有其他參數都必須與 以避免非預期的行為

舉例來說，假設對內含 100,000 的帳戶執行以下查詢 offerId 值，且 pageSize 設為 200，結果僅包含 200 個 第一個回應中的 ReportRow 物件，以及 nextPageToken：

SELECT offerId, impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2021-12-01' AND '2021-12-31'

以下是回應範例 (前五筆結果 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"
}

如要擷取下 200 列資料，請使用相同頁面大小再次傳送要求。 但將要求的 pageToken 更新為 nextPageToken 。