লগিং

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

লগ স্তর

লাইব্রেরিটি বিভিন্ন ধরণের ইভেন্টকে বিভিন্ন লগ লেভেলে লগ করে। একটি সফল API রেসপন্সের ক্ষেত্রে, সারসংক্ষেপটি INFO তে এবং সম্পূর্ণ রিকোয়েস্ট ও রেসপন্সটি DEBUG তে লগ করা হয়। যে রিকোয়েস্টের ফলে API এরর হয়, তার সারসংক্ষেপ বার্তাটি WARN এ এবং সম্পূর্ণ রিকোয়েস্ট ও রেসপন্সটি INFO তে লগ করা হয়।

লগ টাইপ	লগ নাম	সাফল্যের স্তর	ব্যর্থতার স্তর
সারসংক্ষেপ	Google.Ads.GoogleAds.Summary	তথ্য	সতর্ক করুন
বিস্তারিত	Google.Ads.GoogleAds.Detail	ডিবাগ	তথ্য

আংশিক ব্যর্থতার ক্ষেত্রে, সেই ব্যর্থতার বিস্তারিত তথ্য DEBUG মোডে থাকা DETAIL লগারে লগ করা হয়।

কনফিগারেশন

ক্লায়েন্ট লাইব্রেরিটি সমস্ত লগিং কাজের জন্য একটি কাস্টম ক্লাস ব্যবহার করে এবং এটি GoogleAdsLogger মডিউলের মাধ্যমে উপলব্ধ। এই ক্লাসটি একটি ডিফল্ট কনফিগারেশন প্রদান করে, যেখানে সামারি এবং ডিটেইল উভয় লগারই আপনার HOME ডিরেক্টরির অধীনে থাকা logs ফোল্ডারের ফাইলগুলিতে ডেটা লেখে।

Log4perl কনফিগারেশন কাস্টমাইজ করুন

আপনি আপনার HOME ডিরেক্টরিতে একটি কাস্টম log4perl.conf ফাইল প্রদান করে, অথবা API কল করার আগে আপনার অ্যাপ্লিকেশনে সরাসরি Log::Log4perl ইনিশিয়ালাইজ করে ডিফল্ট কনফিগারেশন ওভাররাইড করতে পারেন।

লগগুলি সক্ষম বা অক্ষম করুন

নিম্নলিখিত হেল্পার মেথডগুলো ব্যবহার করে প্রোগ্রাম্যাটিকভাবে লগিং চালু বা বন্ধ করা যায়:

• উভয় লগারের জন্য লগিং সক্রিয় করুন (লেভেল DEBUG এ সেট করতে 1 পাস করুন, যাতে সফল কলগুলির জন্য সম্পূর্ণ অনুরোধ এবং প্রতিক্রিয়া পেলোড লগ করা হয়):

  use Google::Ads::GoogleAds::Logging::GoogleAdsLogger;
  
  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);
  

• সমস্ত লগিং নিষ্ক্রিয় করুন:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();
  

• সারাংশ লগিং নিষ্ক্রিয় করুন:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
  

• বিস্তারিত লগিং নিষ্ক্রিয় করুন:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
  

অনুরোধগুলি কীভাবে লগ করা হবে তার উপর আরও বেশি নিয়ন্ত্রণের জন্য আপনি সরাসরি GoogleAdsLogger ক্লাসের মেথডগুলি ব্যবহার করতে পারেন।