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
クラスのメソッドを直接使用すると、リクエストのロギング方法をさらに細かく制御できます。