การบันทึก

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