क्वेरी के नतीजे पेज पर नंबर डालें

बहुत ज़्यादा पंक्तियों वाले नतीजे के सेट को मैनेज करने के लिए, व्यापारी/कंपनी/कारोबारी Center क्वेरी लैंग्वेज में पेज नंबर इस्तेमाल करने की सुविधा होती है. दो पैरामीटर उपलब्ध हैं reports.search अनुरोध में पेज नंबर कंट्रोल करें मुख्य हिस्सा: जवाब में एक आउटपुट फ़ील्ड के अलावा, page_size और page_token मुख्य हिस्सा: next_page_token.

page_size पैरामीटर से यह पता चलता है कि एक बार अनुरोध करना होगा. अगर बताया न गया हो, तो अपने-आप सबसे ज़्यादा पेज साइज़ पर सेट हो जाता है 1,000 पंक्तियों में से.

page_token पैरामीटर से पता चलता है कि पेज पर किस टोकन का इस्तेमाल करना है. अगर आपने कोई जानकारी नहीं होती, तो पहला पेज लौटाया जाता है. बाद के पेज को फिर से पाने के लिए, पिछले reports.search कॉल से next_page_token के तौर पर मिला मान को page_token के तौर पर उपलब्ध कराया जाना चाहिए. page_token दिए जाने पर, बाकी सभी कॉल के पैरामीटर पिछले कॉल से मेल खाने चाहिए, अनचाहे व्यवहार से बचने के लिए, page_token.

उदाहरण:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2021-12-01' AND '2021-12-31'

इस क्वेरी के लिए, मान लें कि खाते में 1,00,000 offer_ids हैं और page_size को 200 पर सेट किया गया है. इसके बाद, नतीजे के सेट में 200 ReportRow होंगे पहले जवाब में ऑब्जेक्ट और next_page_token के साथ दिखेंगे.

अगली 200 पंक्तियां फिर से पाने के लिए, उसी पेज आकार के साथ अनुरोध फिर से भेजें, लेकिन अनुरोध के page_token को पिछले जवाब के next_page_token.

यहां जवाब के मुख्य हिस्से का उदाहरण दिया गया है (पहले पांच नतीजे और next_page_token):

{
  "results": [
    {
      "segments": {
        "offerId": "12345"
      },
      "metrics": {
        "clicks": "0",
        "impressions": "59",
        "ctr": 0
      }
    },
    {
      "segments": {
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "9625",
        "impressions": "276695",
        "ctr": 0.034785594246372356
      }
    },
    {
      "segments": {
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "148",
        "impressions": "22045",
        "ctr": 0.0067135404853708325
      }
    },
    {
      "segments": {
        "offerId": "12348"
      },
      "metrics": {
        "clicks": "11",
        "impressions": "1100",
        "ctr": 0.01
      }
    },
    {
      "segments": {
        "offerId": "12349"
      },
      "metrics": {
        "clicks": "569",
        "impressions": "62977",
        "ctr": 0.0090350445400701838
      }
    },
    ...
  ],
  "nextPageToken": "CMgB"
}