Paginate query results

Merchant Center क्वेरी लैंग्वेज, पेजेशन के लिए ये फ़ील्ड उपलब्ध कराती है:

• 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 उस जवाब में अपने-आप नहीं भरा जाता जिसमें पंक्तियों का आखिरी बैच होता है.