ロギング

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

ログレベル

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

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

部分的な障害の場合、部分的な障害の詳細が DEBUG に記録されます。

構成

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

ロギングは、次の方法で有効または無効にできます。

  • 両方のロガーのロギングを有効にします。

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

  • 要約ロギングを無効にします。

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

  • 詳細ロギングを無効にします。

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

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