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

GoogleAdsService.Search 10,000 সারির নির্দিষ্ট পৃষ্ঠার আকারে পেজিং সমর্থন করে। ক্যোয়ারীটির ফলাফল সেটটি একাধিক প্রতিক্রিয়ায় বিভক্ত, যার প্রতিটিতে 10,000টি বস্তু।

একটি উদাহরণ হিসাবে, নিম্নলিখিত প্রশ্নের জন্য:

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

যদি আপনার অ্যাকাউন্টে 50,000টি কীওয়ার্ড থাকে, তাহলে ফলাফল সেটে একটি next_page_token সহ প্রথম প্রতিক্রিয়ায় 10,000 GoogleAdsRow অবজেক্ট থাকবে।

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

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

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

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