Merchant Center Sorgu Dili, sayfalara ayırma işlemi için aşağıdaki alanları sağlar:
pageSize
: Tek bir istekte alınacak maksimum satır sayısıdır. Varsayılan olarak maksimum sayfa boyutu 1.000 satırdır.pageToken
: Döndürülecek sayfanın jetonu. Belirtilmemişse ilk sayfa döndürülür.nextPageToken
: Biraccounts.reports.search
görüşmesinden sonraki sayfayı almak için kullanılanpageToken
değeri.
Bir pageToken
sağlandığında beklenmedik davranışları önlemek için çağrıdaki diğer tüm parametrelerin önceki çağrıyla eşleşmesi gerekir.
Örneğin, aşağıdaki sorguyu 100.000 offerId
değeri olan bir hesapta yaparsanız ve pageSize
200 olarak ayarlanırsa sonuç, nextPageToken
ile birlikte ilk yanıtta yalnızca 200 ReportRow
nesnesi içerir:
SELECT offerId, impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2021-12-01' AND '2021-12-31'
Aşağıda örnek yanıt verilmiştir (ilk beş sonuç ve 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"
}
Sonraki 200 satırı almak için isteği aynı sayfa boyutuyla tekrar gönderin ancak isteğin pageToken
değerini önceki yanıttan nextPageToken
olarak güncelleyin.