การบันทึก

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

ระดับบันทึก

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

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

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