প্রচুর সংখ্যক সারি সমন্বিত ফলাফল সেট পরিচালনা করার জন্য, Merchant Center Query Language পেজিনেশন সমর্থন করে। দুইটি পরামিতি reports.search পৃষ্ঠা সংখ্যা নিয়ন্ত্রণের জন্য উপলব্ধ। অনুসন্ধানের অনুরোধের বডি : page_size এবং page_token , প্রতিক্রিয়া বডিতে একটি আউটপুট ক্ষেত্র ছাড়াও: next_page_token ।
page_size প্যারামিটারটি একটি অনুরোধে পুনরুদ্ধারের জন্য সর্বাধিক সংখ্যক সারি নির্দিষ্ট করে। অনির্দিষ্ট থাকলে, এটি স্বয়ংক্রিয়ভাবে 1000 সারির সর্বোচ্চ পৃষ্ঠা আকারে সেট করা হয়।
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'
এই প্রশ্নের জন্য, ধরে নিন অ্যাকাউন্টটিতে 100,000 offer_ids রয়েছে এবং page_size 200-এ সেট করা হয়েছে। ফলাফল সেটে তারপর একটি next_page_token সহ প্রথম প্রতিক্রিয়ায় 200টি ReportRow অবজেক্ট থাকবে।
পরবর্তী 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"
}