Bu sayfa, Cloud Translation API ile çevrilmiştir.

Sorgu sonuçlarını sayfalara ayırma

Satıcı, çok sayıda satır içeren sonuç kümelerini işlemek için Center Query Language, sayfalara ayırma özelliğini destekliyor. İki parametre kullanılabilir reports.search isteğindeki sayfaları numaralandırmayı kontrol et gövde: Yanıttaki bir çıkış alanına ek olarak page_size ve page_token gövde: next_page_token.

page_size parametresi, tek istek. Belirtilmemişse otomatik olarak maksimum sayfa boyutuna ayarlanır oluşan bir liste oluşturabilirsiniz.

page_token parametresi, döndürülecek sayfanın jetonunu belirtir. Eğer belirtilmezse ilk sayfa döndürülür. Sonraki bir sayfayı getirmek için önceki reports.search aramasından next_page_token olarak alınan değer page_token olarak sağlanmalıdır. page_token sağlandığında diğer tüm çağrıdaki parametrelerin, Beklenmeyen davranışlardan kaçınmak için page_token.

Ö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 ve page_size 200 olarak ayarlandı. Böylece sonuç kümesi 200 ReportRow değerini içerir ilk yanıtta, next_page_token ile birlikte nesneler.

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.

Aşağıda bir yanıt gövdesi örneği 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"
}

Segmentasyon