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

GoogleAdsService.Search আপনার অনুরোধে page_size উল্লেখ করে পেজিং সমর্থন করে। এটি ক্যোয়ারীটির ফলাফল সেটকে একাধিক প্রতিক্রিয়ায় বিভক্ত করে, যার প্রতিটিতে page_size পর্যন্ত অবজেক্টের সংখ্যা থাকে। যদি page_size নির্দিষ্ট করা না থাকে, তাহলে এটি স্বয়ংক্রিয়ভাবে সর্বোচ্চ 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টি কীওয়ার্ড থাকে এবং page_size 1,000 -এ সেট করা থাকে, তাহলে ফলাফল সেটে একটি next_page_token সহ প্রথম প্রতিক্রিয়ায় 1,000টি GoogleAdsRow অবজেক্ট থাকবে।

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

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

Google Ads API অভ্যন্তরীণভাবে সম্পূর্ণ ডেটা সেট ক্যাশ করে, তাই পরবর্তী অনুরোধগুলি প্রাথমিকের চেয়ে দ্রুত হয়। আপনার ব্যবহারের ক্ষেত্রের উপর নির্ভর করে, আপনি 1 থেকে 10,000 এর মধ্যে যেকোনো মানতে page_size সেট করতে পারেন। সাধারণভাবে, দ্রুত সামগ্রিক পারফরম্যান্সের জন্য, কম রাউন্ড ট্রিপের জন্য একটি বড় page_size ব্যবহার করুন।

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

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