เปิดใช้การบันทึก

คุณสามารถบันทึกคำขอ การตอบกลับ และข้อความสรุปที่ส่งไปยัง Google Ads API ได้โดยใช้ เครื่องบันทึกเริ่มต้นในไลบรารีของไคลเอ็นต์ Ruby หรือเครื่องบันทึก Ruby ที่กำหนดเอง หากไม่ได้ระบุการกำหนดค่าการบันทึก ระบบจะปิดใช้การบันทึกโดยค่าเริ่มต้น

ระดับบันทึก

ไลบรารีจะบันทึกเหตุการณ์ในระดับบันทึกต่างๆ โดยขึ้นอยู่กับผลลัพธ์ของคำขอ API ดังนี้

การกำหนดค่า

คุณกำหนดค่าการบันทึกในไฟล์การกำหนดค่า google_ads_config.rb หรือแบบเป็นโปรแกรมในขณะรันไทม์ได้

เครื่องบันทึกเริ่มต้น

ตั้งค่าเครื่องบันทึกเริ่มต้นโดยระบุฟิลด์ log_level และ log_target ในไฟล์ google_ads_config.rb ดังนี้

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

เครื่องบันทึกที่กำหนดเอง

นอกจากนี้ คุณยังระบุอินสแตนซ์ Ruby Logger ที่กำหนดเองได้โดยใช้ฟิลด์ 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.service.<name>) หลังจากตั้งค่า client.logger เท่านั้น

require 'logger'

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