Sorgu sonuçlarını sayfalara ayırma

Merchant Center Sorgu Dili, çok sayıda satır içeren sonuç kümelerini işlemek için sayfalara ayırma özelliğini destekler. Sayfalara ayırma işlemini reports.search istek gövdesinde kontrol etmek için iki parametre kullanılabilir: page_size ve page_token. Buna ek olarak, yanıt gövdesindeki bir çıkış alanı:next_page_token.

page_size parametresi, tek bir istekte alınacak maksimum satır sayısını belirtir. Belirtilmemişse otomatik olarak 1.000 satırlık maksimum sayfa boyutuna ayarlanır.

page_token parametresi, döndürülecek sayfanın jetonunu belirtir. Belirtilmemişse ilk sayfa döndürülür. Sonraki bir sayfayı almak için önceki reports.search çağrısında next_page_token olarak alınan değer page_token olarak sağlanmalıdır. page_token sağlandığında, beklenmedik davranışları önlemek için çağrıdaki diğer tüm parametreler, page_token değerini döndüren önceki çağrıyla eşleşmelidir.

Örnek:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2021-12-01' AND '2021-12-31'

Bu sorgu için hesabın 100.000 offer_ids içerdiğini ve page_size öğesinin 200 olarak ayarlandığını varsayalım. Daha sonra sonuç kümesi, ilk yanıtta bir next_page_token ile birlikte 200 ReportRow nesnesi içerir.

Sonraki 200 satırı almak için isteği aynı sayfa boyutuyla tekrar gönderin ancak isteğin page_token değerini önceki yanıtın next_page_token ile güncelleyin.

Bir yanıt gövdesi örneği aşağıda verilmiştir (ilk beş sonuç artı next_page_token):

{
  "results": [
    {
      "segments": {
        "offerId": "12345"
      },
      "metrics": {
        "clicks": "0",
        "impressions": "59",
        "ctr": 0
      }
    },
    {
      "segments": {
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "9625",
        "impressions": "276695",
        "ctr": 0.034785594246372356
      }
    },
    {
      "segments": {
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "148",
        "impressions": "22045",
        "ctr": 0.0067135404853708325
      }
    },
    {
      "segments": {
        "offerId": "12348"
      },
      "metrics": {
        "clicks": "11",
        "impressions": "1100",
        "ctr": 0.01
      }
    },
    {
      "segments": {
        "offerId": "12349"
      },
      "metrics": {
        "clicks": "569",
        "impressions": "62977",
        "ctr": 0.0090350445400701838
      }
    },
    ...
  ],
  "nextPageToken": "CMgB"
}
Önceki
Segmentasyon