การบันทึก
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
คำขอ คำตอบ และข้อความสรุปที่ส่งไปยัง Google Ads API สามารถ
บันทึกด้วยเครื่องมือบันทึกที่กำหนดเองของคุณเองหรือเครื่องมือบันทึกเริ่มต้นในไลบรารีของไคลเอ็นต์
สำหรับ Perl
ระดับบันทึก
ไลบรารีจะบันทึกเหตุการณ์ประเภทต่างๆ ไปยังระดับบันทึกที่แตกต่างกัน เมื่อ API ตอบกลับสำเร็จ ระบบจะบันทึกสรุปที่ INFO และบันทึกคำขอและการตอบกลับทั้งหมดที่ DEBUG ในคำขอที่ทำให้เกิดข้อผิดพลาดของ API ระบบจะบันทึกข้อความสรุปที่ WARN และบันทึกคำขอและการตอบกลับทั้งหมดที่ INFO
| ประเภทของบันทึก |
ชื่อบันทึก |
ระดับความสำเร็จ |
ระดับความล้มเหลว |
| สรุป |
Google.Ads.GoogleAds.Summary |
ข้อมูล |
WARN |
| รายละเอียด |
Google.Ads.GoogleAds.Detail |
DEBUG |
ข้อมูล |
สำหรับความล้มเหลวบางส่วน ระบบจะบันทึกรายละเอียดความล้มเหลวบางส่วนไว้ที่ DEBUG
การกำหนดค่า
ไลบรารีของไคลเอ็นต์ใช้คลาสที่กำหนดเองเพื่อวัตถุประสงค์ในการบันทึกทั้งหมด และจะแสดงผ่านโมดูล GoogleAdsLogger
คลาสนี้มีการกำหนดค่าเริ่มต้นที่ทั้งเครื่องมือบันทึกข้อมูลสรุปและเครื่องมือบันทึกรายละเอียดจะบันทึกลงในไฟล์ที่เกี่ยวข้องในโฟลเดอร์ logs ภายใต้ไดเรกทอรี HOME
แต่คุณสามารถลบล้างการกำหนดค่าเริ่มต้นได้โดยระบุไฟล์ log4perl.conf ในไดเรกทอรี HOME
คุณเปิด/ปิดใช้การบันทึกได้โดยใช้วิธีต่อไปนี้
คุณสามารถใช้วิธีการของคลาส GoogleAdsLogger ได้โดยตรงเพื่อควบคุมวิธีบันทึกคำขอได้มากยิ่งขึ้น
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-27 UTC
[null,null,["อัปเดตล่าสุด 2025-08-27 UTC"],[[["\u003cp\u003eThe Google Ads API client library for Perl allows logging of requests, responses, and summaries using a custom or default logger.\u003c/p\u003e\n"],["\u003cp\u003eLogging levels include \u003ccode\u003eINFO\u003c/code\u003e, \u003ccode\u003eDEBUG\u003c/code\u003e, and \u003ccode\u003eWARN\u003c/code\u003e, used to categorize different event types like successes, failures, and partial failures.\u003c/p\u003e\n"],["\u003cp\u003eThe default logger configuration saves logs to the \u003ccode\u003elogs\u003c/code\u003e folder in your home directory, which can be customized by providing a \u003ccode\u003elog4perl.conf\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eLogging can be controlled through the \u003ccode\u003eGoogleAdsLogger\u003c/code\u003e module, allowing for enabling/disabling logging or more advanced customization.\u003c/p\u003e\n"]]],[],null,["# Logging\n\nRequests, responses, and summary messages made to the Google Ads API can be\nlogged with your own custom logger or the default logger in the client library\nfor Perl.\n\nLog Levels\n----------\n\nThe library will log different types of events to different log levels. On a\nsuccessful API response, the summary will be logged at `INFO`, and the full\nrequest and responses will be logged at `DEBUG`. On a request that resulted in\nan API error, the summary message will be logged at `WARN` and the full request\nand response will be logged at `INFO`.\n\n| Log type | Log name | Success level | Failure level |\n|----------|------------------------------|---------------|---------------|\n| SUMMARY | Google.Ads.GoogleAds.Summary | INFO | WARN |\n| DETAIL | Google.Ads.GoogleAds.Detail | DEBUG | INFO |\n\nFor partial failures, the partial failure details will be logged at `DEBUG`.\n\nConfiguration\n-------------\n\nThe client library uses a custom class for all logging purposes and is exposed\nthrough the [GoogleAdsLogger](https://github.com/googleads/google-ads-perl/blob/HEAD/lib/Google/Ads/GoogleAds/Logging/GoogleAdsLogger.pm)\nmodule. This class provides a default configuration that both summary and detail\nloggers will log to relative files in the `logs` folder under your `HOME` directory.\nBut the default configuration can be overridden by providing a\n[log4perl.conf](https://github.com/googleads/google-ads-perl/blob/HEAD/log4perl.conf)\nfile in your `HOME` directory.\n\nLogging can be enabled/disabled using the following methods:\n\n- Enables logging for both loggers.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();\n\n- Disables the summary logging.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();\n\n- Disables the detail logging.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();\n\nYou can use the methods of the `GoogleAdsLogger` class directly for even more\ncontrol over how requests are logged."]]
