您可以設定程式庫,讓系統在 。您可以記錄詳細的要求和回應 以及更簡潔的摘要訊息這些設定是由 用戶端程式庫設定。下方將進一步說明 以及可用的設定選項類型
程式庫使用 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 以自訂記錄 搭配自訂邏輯攔截器。請參閱記錄 指南 ,取得詳細資料和自訂記錄攔截器範例。