記錄

您可以設定程式庫，以多種方式記錄與 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 檔案中的記錄設定，請務必在用戶端初始化「之前」呼叫上述幾行程式碼。

記錄層級

用戶端會產生多個不同層級的記錄，您可以調整設定，以檢視下列部分或全部項目：

等級	成功的要求	要求失敗
DEBUG	以 JSON 格式含有完整要求和回應物件的詳細記錄。	以 JSON 格式含有完整要求和例外狀況物件的詳細記錄。
INFO	含特定要求和回應欄位的簡要摘要。	以 JSON 格式含有完整要求和例外狀況物件的詳細記錄。
WARNING	無	簡要說明，提供特定要求資訊、例外狀況狀態和訊息。

Python 記錄架構會忽略較不嚴重的記錄訊息，因此設為 WARNING 表示只會看到與失敗要求相關的精簡訊息，但設為 DEBUG 表示您將會在上表中看到所有可能類型的記錄。

正在記錄到檔案

您可以輕鬆地將記錄訊息傳遞到檔案，例如執行 get_campaigns 範例時：

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

記錄攔截器

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