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

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

ระดับการบันทึก

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

ประเภทของกิจกรรม	ระดับบันทึกสรุป	ระดับบันทึกคำขอและการตอบกลับแบบเต็ม
การตอบกลับจาก API ที่สำเร็จ	INFO	DEBUG
ข้อผิดพลาดของ API	WARN	INFO
ไม่สำเร็จบางส่วน	ไม่มี	DEBUG (รายละเอียดความล้มเหลวบางส่วน)

ข้อควรระวัง: ที่ระดับ DEBUG บันทึกจะมีเพย์โหลดคำขอและการตอบกลับที่สมบูรณ์ ซึ่งอาจรวมถึงข้อมูลบัญชีที่ละเอียดอ่อนและสร้างปริมาณบันทึกจำนวนมาก ใช้ DEBUG สำหรับการแก้ปัญหาในเครื่องเท่านั้น และอย่าเปิดใช้การบันทึก DEBUG ไว้ในสภาพแวดล้อมฮาร์ดแวร์และซอฟต์แวร์

การกำหนดค่า

คุณสามารถกำหนดค่าการบันทึกในไฟล์การกำหนดค่า 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)