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

Google Ads Query Language আপনার অনুরোধে 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 এর মান প্রতিবার আলাদা হতে পারে।

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

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

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