ロギング

このライブラリは、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 ファイルのロギング構成をプログラムでオーバーライドする場合は、 クライアントが初期化される前に上記の行を呼び出します。

ログレベル

クライアントはいくつかのレベルでログを生成します。また、ユーザーは任意のレベルで すると、以下の内容の一部またはすべてが表示されます。

Python ロギング フレームワークでは重要度の低いログ メッセージが無視されるため、 WARNING に設定すると、追加されたレベル 失敗したリクエストに関連する簡潔なメッセージが表示される。ただし、DEBUG に設定すると、 上記の表には、考えられるすべての種類のログが表示されます。

ファイルへのロギング

ログメッセージは簡単にファイルにパイプできます。たとえば get_campaigns の例:

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

ロギング インターセプタ

Python クライアント ライブラリでは gRPC が リクエストにアクセスしてログに記録するためのインターセプタ レスポンスの詳細が含まれます。独自のカスタム ロギングを設定するには、gRPC ログを作成することで インターセプタとカスタムロジックを実装しています詳細については、Logging ガイド をご覧ください。