記錄

對 Google Ads API 發出的要求、回應和摘要訊息,可使用您自訂的記錄器,或是 Perl 用戶端程式庫中的預設記錄器進行記錄。

紀錄層級

程式庫會將不同類型的事件記錄到不同的記錄層級。收到成功的 API 回應時,摘要會記錄在 INFO,而完整的要求和回應會記錄在 DEBUG。針對導致 API 錯誤的要求,系統會將摘要訊息記錄在 WARN,完整要求和回應則會記錄在 INFO 中。

記錄檔類型 記錄檔名稱 成功等級 失敗等級
摘要 Google.Ads.GoogleAds.Summary 資訊 警告
詳細資料 Google.Ads.GoogleAds.Detail 偵錯 資訊

如果部分失敗,則部分失敗的詳細資料會記錄在 DEBUG

設定

用戶端程式庫會將自訂類別用於所有記錄用途,並透過 GoogleAdsLogger 模組公開。這個類別提供預設設定,摘要和詳細資料記錄器會記錄至 HOME 目錄下 logs 資料夾中的相對檔案。但只要在 HOME 目錄中提供 log4perl.conf 檔案,即可覆寫預設設定。

您可以透過下列方法啟用/停用記錄功能:

  • 兩個記錄器都會啟用記錄功能。

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
    
  • 停用摘要記錄功能。

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
    
  • 停用詳細記錄功能。

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
    

您可以直接使用 GoogleAdsLogger 類別的方法,進一步控制要求的記錄方式。