Paginate query results

মার্চেন্ট সেন্টার কোয়েরি ল্যাঙ্গুয়েজ পেজিনেশনের জন্য নিম্নলিখিত ফিল্ডগুলো প্রদান করে:

• pageSize : একটিমাত্র অনুরোধে সর্বাধিক যতগুলো সারি পাওয়া যাবে। ডিফল্ট হিসেবে সর্বোচ্চ পেজ সাইজ ১০০০ সারি থাকে।
• pageToken : যে পৃষ্ঠাটি ফেরত দেওয়া হবে তার টোকেন। এটি নির্দিষ্ট না করা হলে, প্রথম পৃষ্ঠাটি ফেরত দেওয়া হয়।
• nextPageToken : accounts.reports.search কল থেকে পরবর্তী পৃষ্ঠা পাওয়ার জন্য pageToken মান।

যখন একটি pageToken প্রদান করা হয়, তখন অপ্রত্যাশিত আচরণ এড়ানোর জন্য কলের অন্যান্য সমস্ত প্যারামিটার অবশ্যই পূর্ববর্তী কলের সাথে মিলতে হবে।

উদাহরণস্বরূপ, যদি আপনি এমন একটি অ্যাকাউন্টে নিম্নলিখিত কোয়েরিটি চালান যেখানে ১,০০,০০০টি offer_id ভ্যালু আছে এবং pageSize ২০০-তে সেট করা আছে, তাহলে ফলাফলের প্রথম রেসপন্সে একটি nextPageToken সহ শুধুমাত্র ২০০টি ReportRow অবজেক্ট থাকবে:

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"
}

পরবর্তী ২০০টি সারি পুনরুদ্ধার করতে, একই পেজ সাইজ ব্যবহার করে অনুরোধটি আবার পাঠান, কিন্তু অনুরোধের pageToken পূর্ববর্তী প্রতিক্রিয়া থেকে nextPageToken দিয়ে আপডেট করুন।

মূল বিষয়: যে রেসপন্সটিতে সারিগুলোর শেষ ব্যাচ থাকে, সেটিতে nextPageToken পূরণ করা হয় না।