क्वेरी के नतीजे पेज पर नंबर डालें

बड़ी संख्या में लाइन वाले नतीजे के सेट मैनेज करने के लिए, Merchant Center की क्वेरी लैंग्वेज में पेजों को क्रम में लगाया जा सकता है. reports.searchअनुरोध में पेजों को क्रम में लगाने के लिए दो पैरामीटर इस्तेमाल किए जा सकते हैं: page_size और page_token. साथ ही, रिस्पॉन्स के मुख्य भाग में एक आउटपुट फ़ील्ड जोड़ें:next_page_token.

page_size पैरामीटर से पता चलता है कि एक बार में ज़्यादा से ज़्यादा कितनी पंक्तियां फ़ेच की जा सकती हैं. अगर कोई जानकारी न दी गई हो, तो वह पेज के साइज़ के लिए अपने-आप 1,000 लाइनों पर सेट होती है.

page_token पैरामीटर से, पेज के टोकन के बारे में पता चलता है. अगर इसे तय नहीं किया गया है, तो पहला पेज दिखेगा. बाद वाले पेज को फिर से पाने के लिए, next_page_token के तौर पर पिछले reports.search कॉल से मिले मान को page_token के रूप में दिया जाना चाहिए. page_token दिए जाने पर, कॉल के सभी दूसरे पैरामीटर उस पिछले कॉल से मेल खाने चाहिए जिसने page_token को अनचाहे व्यवहार से बचाया था.

उदाहरण:

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

इस क्वेरी के लिए, मान लें कि खाते में 100,000 offer_ids है और page_size 200 पर सेट है. नतीजे के सेट में, पहले रिस्पॉन्स में next_page_token के साथ 200 ReportRowऑब्जेक्ट होंगे.

अगली 200 लाइनें फिर से पाने के लिए, पेज के साइज़ के मुताबिक अनुरोध फिर से भेजें. हालांकि, अनुरोध के page_token को पिछले रिस्पॉन्स के next_page_token पर अपडेट करें.

यहां जवाब के मुख्य हिस्से का उदाहरण दिया गया है (पहले पांच नतीजों के साथ-साथ 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"
}
पीछे जाएं
सेगमेंटेशन