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

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

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

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

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

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

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

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

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