লগ করা চালু করুন

আপনি Google Ads API-তে পাঠানো অনুরোধ, উত্তর ও সারসংক্ষেপ মেসেজ লগ করতে পারেন। এর জন্য Ruby ক্লায়েন্ট লাইব্রেরিতে থাকা ডিফল্ট লগার অথবা আপনার নিজস্ব কাস্টম Ruby লগার ব্যবহার করতে পারেন। কোনও লগিং কনফিগারেশন প্রদান করা না হলে, ডিফল্ট হিসেবে লগিং বন্ধ করা থাকে।

লগ লেভেল

API অনুরোধের ফলাফলের উপর নির্ভর করে লাইব্রেরি বিভিন্ন লগ লেভেলে ইভেন্ট লগ করে:

ইভেন্টের প্রকার	সারসংক্ষেপ লগ লেভেল	সম্পূর্ণ অনুরোধ ও উত্তর লগ লেভেল
API থেকে পাওয়া সফল রেসপন্স	INFO	DEBUG
API সংক্রান্ত সমস্যা	WARN	INFO
আংশিক কাজ করেনি	কোনওটিই নয়	DEBUG (আংশিক কাজ না করার বিবরণ)

সতর্কতা: DEBUG লেভেলে, লগে সম্পূর্ণ অনুরোধ ও উত্তর পে-লোড থাকে, যার মধ্যে সংবেদনশীল অ্যাকাউন্ট ডেটা থাকতে পারে এবং এর ফলে প্রচুর পরিমাণে লগ তৈরি হতে পারে। শুধুমাত্র স্থানীয় সমস্যার সমাধান করার জন্য DEBUG ব্যবহার করুন এবং প্রোডাকশন এনভায়রনমেন্টে DEBUG লগিং চালু রাখবেন না।

কনফিগারেশন

আপনি google_ads_config.rb কনফিগারেশন ফাইল বা রানটাইমে প্রোগ্রাম্যাটিক উপায়ে লগিং কনফিগার করতে পারবেন।

ডিফল্ট লগার

আপনার google_ads_config.rb ফাইলে log_level এবং log_target ফিল্ড উল্লেখ করে ডিফল্ট লগার সেট-আপ করুন:

Google::Ads::GoogleAds::Config.new do |c|
  # Valid levels: 'DEBUG', 'INFO', 'WARN', 'ERROR', 'FATAL'
  c.log_level = 'INFO'

  # Output destination, such as STDOUT, STDERR, or a file path
  c.log_target = STDOUT
end

কাস্টম লগার

এছাড়াও, আপনি logger ফিল্ড ব্যবহার করে নিজের কাস্টম Ruby Logger ইনস্ট্যান্স নির্দিষ্ট করতে পারবেন। আপনি logger উল্লেখ করলে, log_level ও log_target উপেক্ষা করা হয়:

require 'logger'

# In google_ads_config.rb:
Google::Ads::GoogleAds::Config.new do |c|
  c.logger = Logger.new('log/google_ads.log')
end

এছাড়াও, আপনি client.logger= ব্যবহার করে ক্লায়েন্ট ইনস্ট্যানশিয়েট করার পরে কাস্টম লগার অ্যাসাইন করতে পারবেন। মনে রাখবেন, এটি শুধুমাত্র client.logger সেট করার পরে (client.service.<name>) আনা পরিষেবা ক্লায়েন্টদের উপর প্রভাব ফেলে:

require 'logger'

client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.logger = Logger.new(STDOUT)