向 Google Ads API 發出的要求、回應和摘要訊息,您可以使用您的自訂記錄器或 Perl 用戶端程式庫中的預設記錄器記錄。
記錄檔層級
程式庫會將不同類型的事件記錄到不同的記錄層級。成功的 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
類別的方法,進一步控制要求的記錄方式。