Paginate query results

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

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

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

उदाहरण के लिए, अगर किसी ऐसे खाते के लिए यह क्वेरी की जाती है जिसमें offer_id की 1,00, 000 वैल्यू हैं और 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 से अपडेट करें.

पीछे जाएं
Use Merchant Center Query Language