記錄

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