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