Bạn có thể ghi lại các yêu cầu, phản hồi và thông báo tóm tắt được gửi đến Google Ads API bằng trình ghi nhật ký tuỳ chỉnh của riêng bạn hoặc trình ghi nhật ký mặc định trong thư viện ứng dụng cho Perl.
Các cấp độ nhật ký
Thư viện ghi lại nhiều loại sự kiện vào các cấp độ nhật ký khác nhau. Đối với phản hồi của API thành công, thông tin tóm tắt sẽ được ghi nhật ký ở cấp độ INFO và toàn bộ yêu cầu và phản hồi sẽ được ghi nhật ký ở cấp độ DEBUG. Đối với yêu cầu dẫn đến lỗi API, thông báo tóm tắt sẽ được ghi lại ở cấp độ WARN và toàn bộ yêu cầu và phản hồi sẽ được ghi lại ở cấp độ INFO.
| Loại nhật ký | Tên nhật ký | Cấp độ thành công | Cấp độ lỗi |
|---|---|---|---|
| TÓM TẮT | Google.Ads.GoogleAds.Summary | INFO (THÔNG TIN) | WARN (CẢNH BÁO) |
| CHI TIẾT | Google.Ads.GoogleAds.Detail | DEBUG (Gỡ lỗi) | INFO (THÔNG TIN) |
Đối với các lỗi một phần, thông tin chi tiết về lỗi một phần sẽ được ghi lại vào trình ghi nhật ký DETAIL ở cấp độ DEBUG.
Cấu hình
Thư viện ứng dụng sử dụng một lớp tuỳ chỉnh cho mọi mục đích ghi nhật ký và được hiển thị
thông qua mô-đun GoogleAdsLogger. Lớp này cung cấp cấu hình mặc định trong đó cả trình ghi nhật ký tóm tắt và chi tiết đều ghi vào các tệp trong thư mục logs trong thư mục HOME của bạn.
Tuỳ chỉnh cấu hình Log4perl
Bạn có thể ghi đè cấu hình mặc định bằng cách cung cấp tệp tuỳ chỉnh
log4perl.conf trong thư mục HOME hoặc bằng cách
khởi chạy Log::Log4perl trực tiếp trong ứng dụng trước khi thực hiện lệnh gọi API.
Bật hoặc tắt nhật ký
Bạn có thể bật hoặc tắt tính năng ghi nhật ký theo phương thức lập trình bằng các phương thức trợ giúp sau:
Bật tính năng ghi nhật ký cho cả hai trình ghi nhật ký (truyền
1để đặt cấp độ thànhDEBUGđể toàn bộ tải trọng yêu cầu và phản hồi được ghi lại cho các lệnh gọi thành công):use Google::Ads::GoogleAds::Logging::GoogleAdsLogger; Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);Tắt mọi tính năng ghi nhật ký:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();Tắt tính năng ghi nhật ký tóm tắt:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();Tắt tính năng ghi nhật ký chi tiết:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
Bạn có thể sử dụng trực tiếp các phương thức của lớp GoogleAdsLogger để kiểm soát nhiều hơn nữa cách ghi nhật ký các yêu cầu.