ফলাফলগুলো পৃষ্ঠা উল্টে দেখুন

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

Search সর্বোচ্চ ১০,০০০ সারি পর্যন্ত নির্দিষ্ট পেজ পাওয়া যায়। SearchGoogleAdsRequest এ page_size সেট করা এখন আর প্রচলিত নয় এবং এটি RequestError.PAGE_SIZE_NOT_SUPPORTED এরর দেখায়।

উদাহরণ কোয়েরি এবং পেজিনেশন

নিম্নলিখিত কোয়েরিটি বিবেচনা করুন:

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 দিয়ে আপডেট করুন:

{
  "query": "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",
  "pageToken": "CN3q9...example_token..."
}

লক্ষ্য করুন যে, সর্বশেষ ব্যাচের সারিগুলো ধারণকারী রেসপন্সটিতে next_page_token পূরণ করা হয় না।

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

ক্যাশিং এবং পেজ টোকেন মেয়াদোত্তীর্ণ

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

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