ロギング

Google Ads API に対して行われたリクエスト、レスポンス、概要メッセージは、独自のカスタム ロガーまたは Perl 用クライアント ライブラリのデフォルト ロガーで記録できます。

ログレベル

ライブラリは、さまざまな種類のイベントをさまざまなログレベルに記録します。API レスポンスが成功すると、概要は INFO に記録され、リクエストとレスポンスの全体は DEBUG に記録されます。API エラーが発生したリクエストでは、概要メッセージが WARN に記録され、リクエストとレスポンス全体が INFO に記録されます。

ログタイプ	ログ名	成功レベル	障害レベル
概要	Google.Ads.GoogleAds.Summary	情報	WARN
詳細	Google.Ads.GoogleAds.Detail	デバッグ	情報

部分的な失敗の場合、部分的な失敗の詳細は DEBUG の DETAIL ロガーに記録されます。

構成

クライアント ライブラリは、すべてのロギング目的でカスタム クラスを使用し、GoogleAdsLogger モジュールを介して公開されます。このクラスは、概要ロガーと詳細ロガーの両方が HOME ディレクトリの logs フォルダにあるファイルに書き込むデフォルト構成を提供します。

Log4perl 構成をカスタマイズする

デフォルトの構成をオーバーライドするには、HOME ディレクトリにカスタムの log4perl.conf ファイルを指定するか、API 呼び出しを行う前にアプリケーションで Log::Log4perl を直接初期化します。

ログを有効または無効にする

ロギングは、次のヘルパー メソッドを使用してプログラムで有効または無効にできます。

• 両方のロガーでロギングを有効にします（1 を渡してレベルを DEBUG に設定し、成功した呼び出しの完全なリクエストとレスポンスのペイロードをログに記録します）。

  use Google::Ads::GoogleAds::Logging::GoogleAdsLogger;
  
  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);
  

• すべてのロギングを無効にします。

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();
  

• 要約ロギングを無効にする:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
  

• 詳細ロギングを無効にする:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
  

GoogleAdsLogger クラスのメソッドを直接使用して、リクエストのロギング方法をさらに細かく制御できます。