পৃষ্ঠায় ক্যোয়ারী ফলাফল

বিপুল সংখ্যক সারি সম্বলিত ফলাফল সেট পরিচালনা করার জন্য, মার্চেন্ট সেন্টার কোয়েরি ল্যাঙ্গুয়েজ পেজিনেশন সমর্থন করে। reports.search রিকোয়েস্ট বডিতে পেজিনেশন নিয়ন্ত্রণ করার জন্য দুটি প্যারামিটার উপলব্ধ রয়েছে: page_size এবং page_token , এছাড়াও রেসপন্স বডিতে একটি আউটপুট ফিল্ড রয়েছে: next_page_token ।

page_size প্যারামিটারটি একটি একক অনুরোধে পুনরুদ্ধার করা সারির সর্বোচ্চ সংখ্যা নির্দিষ্ট করে। যদি এটি নির্দিষ্ট না করা হয়, তবে এটি স্বয়ংক্রিয়ভাবে সর্বোচ্চ পেজ সাইজ অর্থাৎ ১০০০ সারিতে সেট হয়ে যায়।

` 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'

এই কোয়েরির জন্য, ধরে নিন অ্যাকাউন্টটিতে ১,০০,০০০টি offer_ids আছে এবং page_size ২০০-তে সেট করা আছে। সেক্ষেত্রে, ফলাফল সেটের প্রথম রেসপন্সে একটি next_page_token সহ ২০০টি ReportRow অবজেক্ট থাকবে।

পরবর্তী ২০০টি সারি পুনরুদ্ধার করতে, একই পেজ সাইজ ব্যবহার করে অনুরোধটি আবার পাঠান, কিন্তু অনুরোধের ' 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"
}

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