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

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