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

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

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

page_token पैरामीटर, उस पेज के टोकन के बारे में बताता है जिसे वापस लाना है. अगर इसे तय नहीं किया गया है, तो पहला पेज दिखाया जाता है. इसके बाद वाले पेज को वापस पाने के लिए, पिछले reports.search कॉल से मिले next_page_token की वैल्यू को 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'

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

अगली 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"
}