Merchant Center 查詢語言提供下列分頁欄位:
pageSize
:單一要求中要擷取的資料列數量上限。預設值為 1000 列的頁面大小上限。pageToken
:要傳回的網頁權杖。如果未指定,系統會傳回第一頁。nextPageToken
:從accounts.reports.search
呼叫取得下一頁的pageToken
值。
如果提供 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
。