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

ज़्यादा पंक्तियों वाले नतीजों के सेट को मैनेज करने के लिए, 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"
}

अहम जानकारी: next_page_token, पंक्तियों के आखिरी बैच वाले जवाब में नहीं दिखता है.