ফলাফল মাধ্যমে পেজিং

একবারে সম্পূর্ণ ফলাফল সেট ডাউনলোড না করে, আপনি GoogleAdsService.Search এর মাধ্যমে প্রাপ্ত ফলাফলগুলো পৃষ্ঠা উল্টে দেখতে পারেন। Google Ads API-এর রিপোর্টিং সম্পর্কে একটি সার্বিক ধারণা পেতে, রিপোর্টিং গাইডটি দেখুন।

ফলাফল সর্বোচ্চ ১০,০০০ সারি বিশিষ্ট পৃষ্ঠাগুলিতে ফেরত দেওয়া হয়। যদি অনুরোধে page_size সেট করা না থাকে, তবে এটি ডিফল্টরূপে ১০,০০০ হয়। যদি page_size মান ১০,০০০-এর বেশি সেট করা হয়, তবুও এটি ১০,০০০-ই ব্যবহার করে।

উদাহরণস্বরূপ, নিম্নলিখিত কোয়েরিটি বিবেচনা করুন:

SELECT
  ad_group.id,
  ad_group_criterion.type,
  ad_group_criterion.criterion_id,
  ad_group_criterion.keyword.text,
  ad_group_criterion.keyword.match_type
FROM ad_group_criterion
WHERE ad_group_criterion.type = KEYWORD

আপনার অ্যাকাউন্টে ৫০,০০০ কীওয়ার্ড থাকলে, ফলাফল সেটের প্রথম রেসপন্সে একটি next_page_token সহ ১০,০০০টি GoogleAdsRow অবজেক্ট থাকবে।

পরবর্তী ১০,০০০ সারি পুনরুদ্ধার করতে, অনুরোধটি আবার পাঠান, কিন্তু অনুরোধের ' page_token কে প্রতিক্রিয়ার ' next_page_token ' দিয়ে আপডেট করুন। মনে রাখবেন যে, যে প্রতিক্রিয়াটিতে সারিগুলোর সর্বশেষ ব্যাচ থাকে, তাতে next_page_token পূরণ করা হয় না।

আমাদের ক্লায়েন্ট লাইব্রেরিগুলো স্বয়ংক্রিয়ভাবে পেজিং পরিচালনা করে। আপনাকে শুধু রেসপন্সের সারিগুলোর মধ্যে দিয়ে যেতে হবে। বর্তমান পেজের সমস্ত সারি ফেরত আসার পর, ক্লায়েন্ট লাইব্রেরি আপনার পক্ষ থেকে স্বয়ংক্রিয়ভাবে নতুন একটি পেজের সারিগুলো নিয়ে আসে, যতক্ষণ না সম্পূর্ণ ডেটাসেটটি সংগ্রহ করা হয়। gRPC-এর পরিবর্তে REST ব্যবহার করলে, আপনাকে প্রতিটি নতুন পেজের জন্য স্পষ্টভাবে একটি রিকোয়েস্ট করতে হবে।

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

ক্যাশে করা ডেটার সুবিধা নিতে হলে, পরবর্তী অনুরোধগুলিতে আপনার কোয়েরি অবশ্যই হুবহু একই থাকতে হবে। এই অনুরোধগুলি আপনার কোটার মধ্যে গণনা করা হবে না, বিশেষ করে এক্সপ্লোরার অ্যাক্সেস লেভেল এবং বেসিক অ্যাক্সেস লেভেলের ক্ষেত্রে। যদি কোয়েরি ভিন্ন হয় এবং একই পেজ টোকেনের সাথে পাঠানো হয়, তাহলে একটি এরর দেখানো হবে।