記錄

您可以設定程式庫,以多種方式記錄與 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

Logging 攔截器

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