記錄

您可以設定程式庫,讓系統在 。您可以記錄詳細的要求和回應 以及更簡潔的摘要訊息這些設定是由 用戶端程式庫設定。下方將進一步說明 以及可用的設定選項類型

程式庫使用 Python 內建的記錄功能 預設寫入 stderr如果納入的話,logging 物件 會將設定中定義的資料直接傳送至 logging.config.dictConfig 格式為 dict

您還可以設定記錄功能,以程式輔助的方式設定記錄功能 設定,初始化用戶端。您可以擷取用戶端 Logger 執行個體,並使用下列範例進行設定:

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 以自訂記錄 搭配自訂邏輯攔截器。請參閱記錄 指南 ,取得詳細資料和自訂記錄攔截器範例。