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

Merchant Center Query Language, पेज नंबर के हिसाब से नतीजे दिखाने के लिए ये फ़ील्ड उपलब्ध कराता है:

• pageSize: एक अनुरोध में वापस पाने के लिए पंक्तियों की ज़्यादा से ज़्यादा संख्या. डिफ़ॉल्ट रूप से, पेज का ज़्यादा से ज़्यादा साइज़ 1,000 लाइनें होता है.
• pageToken: यह उस पेज का टोकन है जिसे वापस पाना है. अगर इसे तय नहीं किया गया है, तो पहला पेज दिखता है.
• nextPageToken: accounts.reports.search कॉल से अगला पेज पाने के लिए, pageToken वैल्यू.

pageToken की वैल्यू दिए जाने पर, कॉल में मौजूद अन्य सभी पैरामीटर की वैल्यू, पिछली कॉल में मौजूद पैरामीटर की वैल्यू से मेल खानी चाहिए. ऐसा न होने पर, कॉल में गड़बड़ी हो सकती है.

उदाहरण के लिए, अगर आपने किसी ऐसे खाते पर यह क्वेरी की है जिसमें 1,00, 000 offer_id वैल्यू हैं और pageSize को 200 पर सेट किया गया है, तो नतीजे में पहले रिस्पॉन्स में सिर्फ़ 200 ReportRow ऑब्जेक्ट शामिल होंगे. साथ ही, इसमें एक nextPageToken भी शामिल होगा:

SELECT offer_id, impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-31'

यहां जवाब का नमूना दिया गया है (पहले पांच नतीजे और nextPageToken):

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

अगली 200 पंक्तियां पाने के लिए, पेज के उसी साइज़ के साथ अनुरोध को फिर से भेजें. हालांकि, अनुरोध के pageToken को पिछले जवाब के nextPageToken में अपडेट करें.

अहम जानकारी: nextPageToken, जवाब में मौजूद लाइनों के आखिरी बैच में नहीं भरा जाता.