記錄

傳送至 Google Ads API 的要求、回應和摘要訊息可以是 以您自己的自訂記錄器或用戶端程式庫中的預設記錄器記錄 。

紀錄層級

程式庫會將不同類型的事件記錄到不同的記錄層級。使用 成功的 API 回應,摘要會記錄在 INFO,且完整的 要求與回應記錄在 DEBUG。針對造成 API 錯誤,摘要訊息會記錄在 WARN 和完整的要求 且回應記錄在 INFO

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

如果部分失敗,則部分失敗的詳細資料會記錄在 DEBUG

設定

用戶端程式庫會將自訂類別用於所有記錄用途,並公開發布 透過 GoogleAdsLogger 後續課程我們將逐一介紹 預先訓練的 API、AutoML 和自訂訓練這個類別提供預設設定,可包含匯總和詳細資料 記錄器會將記錄到 HOME 目錄下 logs 資料夾中的相對檔案。 不過只要提供 log4perl.conf 複製到 HOME 目錄中

您可以透過下列方法啟用/停用記錄功能:

  • 兩個記錄器都會啟用記錄功能。

    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 類別的方法,享有更多好處 控制要求的記錄方式