การบันทึก

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

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

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

ประเภทของบันทึก ชื่อบันทึก ระดับความสำเร็จ ระดับความล้มเหลว
สรุป Google.Ads.GoogleAds.Summary ข้อมูล WARN
รายละเอียด Google.Ads.GoogleAds.Detail DEBUG ข้อมูล

สำหรับความล้มเหลวบางส่วน ระบบจะบันทึกรายละเอียดความล้มเหลวบางส่วนไว้ในตัวบันทึก DETAIL ที่ DEBUG

การกำหนดค่า

ไลบรารีของไคลเอ็นต์ใช้คลาสที่กำหนดเองเพื่อวัตถุประสงค์ในการบันทึกทั้งหมด และแสดงผ่านโมดูล GoogleAdsLogger คลาสนี้มีการกำหนดค่าเริ่มต้นที่ทั้งตัวบันทึกสรุปและตัวบันทึกรายละเอียดจะเขียนลงในไฟล์ในโฟลเดอร์ logs ใต้ไดเรกทอรี HOME

ปรับแต่งการกำหนดค่า Log4perl

คุณสามารถลบล้างการกำหนดค่าเริ่มต้นได้โดยระบุไฟล์ log4perl.conf ที่กำหนดเองในไดเรกทอรี HOME หรือโดยการเริ่มต้น Log::Log4perl โดยตรงในแอปพลิเคชันก่อนทำการเรียก API

เปิดหรือปิดใช้บันทึก

คุณสามารถเปิดหรือปิดใช้การบันทึกแบบเป็นโปรแกรมได้โดยใช้เมธอดตัวช่วยต่อไปนี้

  • เปิดใช้การบันทึกสำหรับทั้ง 2 ตัวบันทึก (ส่ง 1 เพื่อตั้งค่าระดับเป็น DEBUG เพื่อให้ระบบบันทึกเพย์โหลดคำขอและการตอบกลับแบบเต็มสำหรับการเรียกที่สำเร็จ)

    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 โดยตรงเพื่อให้ควบคุมวิธีบันทึกคำขอได้มากขึ้น