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