記錄

您可以使用自己的自訂記錄器，或 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 類別的方法，進一步控管要求的記錄方式。