Paginate query results

মার্চেন্ট সেন্টার কোয়েরি ল্যাঙ্গুয়েজে পৃষ্ঠাঙ্কনের জন্য নিম্নলিখিত ক্ষেত্রগুলি প্রদান করা হয়:

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

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

উদাহরণস্বরূপ, যদি আপনি এমন একটি অ্যাকাউন্টে নিম্নলিখিত কোয়েরিটি করেন যার 100,000 offer_id মান রয়েছে এবং 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"
}

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