記錄

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

記錄層級

程式庫會將不同類型的事件記錄到不同的記錄層級。在成功的 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 類別的方法，進一步控管要求的記錄方式。