ロギング

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