Paginate query results

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: Bir accounts.reports.search görüşmesinden sonraki sayfayı almak için kullanılan pageToken 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.