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