Paginate query results

Merchant Center क्वेरी भाषा से ये सुविधाएं मिलती हैं खोज नतीजों को पेजों में बांटने के लिए:

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

pageToken दिए जाने पर, कॉल के अन्य सभी पैरामीटर अनचाहे व्यवहार से बचने के लिए, कॉल करें.

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

SELECT offerId, impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2021-12-01' AND '2021-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 में अपडेट करें पिछला जवाब.