Paginate query results

Merchant Center Sorgusu Dil şunları sağlar: sayfalara ayırma:

  • pageSize: Tek bir istekte alınacak maksimum satır sayısı. Varsayılan olarak maksimum sayfa boyutu 1.000 satırdır.
  • pageToken: Döndürülecek sayfanın jetonu. Belirtilmemişse ilk sonucuna varılır.
  • nextPageToken: Bir sonraki sayfayapageToken accounts.reports.search çağrısına bir tıklama URL'si eklemeniz gerekir.

pageToken sağlandığında, çağrıdaki diğer tüm parametreler önceki çağrıya çağrılıyor.

Örneğin, aşağıdaki sorguyu 100.000 offerId değerleri ve pageSize 200 olarak ayarlanırsa sonuç yalnızca 200 değerini içerir İlk yanıtta, nextPageToken ile birlikte ReportRow nesne:

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 öğesininextPageToken önceki yanıt.