Ghi nhật ký

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 gửi đến API Google Ads bằng trình ghi nhật ký tuỳ chỉnh của riêng mình hoặc trình ghi nhật ký mặc định trong thư viện ứng dụng cho Perl.

Cấp độ nhật ký

Thư viện sẽ ghi nhật ký các loại sự kiện khác nhau vào các cấp độ nhật ký khác nhau. Khi API thành công, nội dung tóm tắt sẽ được ghi vào INFO, còn toàn bộ yêu cầu và phản hồi sẽ được ghi vào DEBUG. Khi một yêu cầu dẫn đến lỗi API, thông báo tóm tắt sẽ được ghi vào WARN, đồng thời toàn bộ yêu cầu và phản hồi sẽ được ghi vào INFO.

Loại nhật ký Tên nhật ký Mức độ thành công Mức độ không thành công
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 lỗi một phần, thông tin chi tiết về lỗi một phần sẽ được ghi vào DEBUG.

Cấu hình

Thư viện ứng dụng sử dụng một lớp tuỳ chỉnh cho tất cả các 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 mà cả trình ghi nhật ký tóm tắt và chi tiết sẽ ghi nhật ký vào các tệp tương đối trong thư mục logs thuộc thư mục HOME của bạn. Tuy nhiên, bạn có thể ghi đè cấu hình mặc định bằng cách cung cấp tệp log4perl.conf trong thư mục HOME.

Bạn có thể bật/tắt tính năng ghi nhật ký bằng các phương thức sau:

  • Bật tính năng ghi nhật ký cho cả hai trình ghi nhật ký.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_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 để có nhiều quyền kiểm soát hơn nữa đối với cách ghi nhật ký các yêu cầu.