記錄

您可以設定程式庫，以各種方式記錄與 Google Ads API 的互動情形。您可以記錄詳細要求和回應，以及更精簡的摘要訊息。這些設定由用戶端程式庫設定管理。以下詳細說明可用的不同類型設定選項。

這個程式庫會使用 Python 內建的記錄架構，並預設將記錄資料寫入 stderr。如果納入，則在設定中定義的 logging 物件會以 dict 的形式直接傳遞至 logging.config.dictConfig。

您也可以在初始化用戶端之前，以程式輔助方式設定記錄功能。您可以擷取用戶端記錄器例項，並使用以下範例進行設定：

import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)

請注意，用戶端會在初始化時設定用戶端記錄器。系統會忽略日誌設定的後續變更。為了以程式輔助方式覆寫 YAML 檔案中的記錄設定，請務必在前呼叫上述行程式碼，以便在用戶端初始化時執行。

記錄層級

用戶端會在幾個不同層級產生記錄，您可以設定設定檔，查看下列部分或全部內容：

由於 Python 記錄設定架構會忽略比所設定層級嚴重程度較低的記錄訊息，因此將層級設為 WARNING 表示您只會看到與失敗要求相關的簡短訊息，但將層級設為 DEBUG 則表示您會看到上表中所有可能的記錄類型。

將記錄記錄到檔案

您可以輕鬆將記錄訊息管道傳送至檔案，例如在執行 get_campaigns 範例時：

python get_campaigns.py -c $CLIENT_ID 2> example.log

記錄攔截器

Python 用戶端程式庫會使用 gRPC 攔截器來存取及記錄要求和回應詳細資料。您可以建立含有自訂邏輯的 gRPC 攔截器，藉此設定自訂記錄。如需詳細資訊和自訂記錄攔截器範例，請參閱記錄指南。