Ghi nhật ký

Các yêu cầu, câu trả lời và thông báo tóm tắt được gửi đến API Google Ads có thể bị được ghi lại 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ấ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. Trên phản hồi API thành công, thì bản tóm tắt sẽ được ghi lại vào INFO và toàn bộ và phản hồi sẽ được ghi lại vào DEBUG. Đối với một yêu cầu dẫn đến một lỗi API, thông báo tóm tắt sẽ được ghi lại tại WARN và toàn bộ yêu cầu và phản hồi sẽ được ghi lại 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ả mục đích ghi nhật ký và sẽ được hiển thị thông qua GoogleAdsLogger . Lớp này cung cấp cấu hình mặc định bao gồm cả phần tóm tắt và thông tin chi tiết trình ghi nhật ký sẽ ghi lại 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 một 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ể trực tiếp sử dụng các phương thức của lớp GoogleAdsLogger để làm nhiều việc hơn nữa kiểm soát cách các yêu cầu được ghi lại.