記錄

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

記錄層級

程式庫會將不同類型的事件記錄到不同記錄層級。如果 API 回應成功，摘要會記錄在 INFO，完整的要求和回應則會記錄在 DEBUG。如果要求導致 API 發生錯誤，系統會在 WARN 記錄摘要訊息，並在 INFO 記錄完整的要求和回應。

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

如果部分失敗，系統會將部分失敗詳細資料記錄到 DEBUG 的 DETAIL 記錄器。

設定

用戶端程式庫會使用自訂類別進行所有記錄作業，並透過 GoogleAdsLogger 模組公開。這個類別提供預設設定，摘要和詳細記錄器都會將檔案寫入 HOME 目錄下 logs 資料夾中的檔案。

自訂 Log4perl 設定

如要覆寫預設設定，請在 HOME 目錄中提供自訂 log4perl.conf 檔案，或在發出 API 呼叫前，直接在應用程式中初始化 Log::Log4perl。

啟用或停用記錄

您可以使用下列輔助方法，透過程式輔助方式啟用或停用記錄功能：

• 為兩個記錄器啟用記錄功能 (傳遞 1 將層級設為 DEBUG，以便記錄成功呼叫的完整要求和回應酬載)：

  use Google::Ads::GoogleAds::Logging::GoogleAdsLogger;
  
  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);
  

• 停用所有記錄功能：

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

• 停用摘要記錄：

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

• 停用詳細記錄：

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

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