ফলাফলের মাধ্যমে পৃষ্ঠা

একবারে সম্পূর্ণ ফলাফল সেট ডাউনলোড করার পরিবর্তে 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

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

পরবর্তী ১০,০০০ সারি ফিরিয়ে আনতে, আবার অনুরোধ পাঠান, তবে অনুরোধের 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 ব্যবহার করলে, আপনাকে প্রতিটি নতুন পৃষ্ঠার জন্য স্পষ্টভাবে অনুরোধ করতে হবে।

ক্যাশিং ও পৃষ্ঠা টোকেনের মেয়াদ শেষ হয়ে যাওয়া

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

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

পূর্ববর্তী
স্ট্রিমিং
পরবর্তী
UI-তে রিপোর্ট