このライブラリは、Google Ads API とのインタラクションを 使用できます。詳細なリクエストとレスポンスを、次のようにログに記録できます。 簡潔な概要メッセージも追加できますこれらの設定は クライアント ライブラリの構成。詳細は以下のとおりです。 さまざまなタイプの構成オプションを利用できます。
このライブラリは、Python の組み込み logging を使用します。
フレームワークとログを stderr にデフォルトで出力します。logging オブジェクト（含まれている場合）
その構成で定義した値が直接渡され、
logging.config.dictConfig
dict として。
また、Cloud Logging に Logging ログを設定して、 クライアントを初期化する前のタスクを実行します。クライアントを 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
ロギング インターセプタ
Python クライアント ライブラリでは gRPC が リクエストにアクセスしてログに記録するためのインターセプタ レスポンスの詳細が含まれます。独自のカスタム ロギングを設定するには、gRPC ログを作成することで インターセプタとカスタムロジックを実装しています詳細については、Logging ガイド をご覧ください。