Paginate query results

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 पर अपडेट करें.