記錄

向 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 類別的方法,進一步控制要求的記錄方式。