ロギングを有効にする

Ruby クライアント ライブラリのデフォルトのロガーまたは独自のカスタム Ruby ロガーを使用して、Google Ads API に送信されたリクエスト、レスポンス、サマリー メッセージをログに記録できます。ロギング構成が指定されていない場合、ロギングはデフォルトで無効になります。

ログレベル

ライブラリは、API リクエストの結果に応じて、異なるログレベルでイベントをログに記録します。

イベントの種類 サマリー ログレベル リクエストとレスポンスの完全なログレベル
成功した API レスポンス INFO DEBUG
API エラー WARN INFO
部分的な失敗 なし DEBUG（部分的な失敗の詳細）

構成

ロギングは、google_ads_config.rb 構成ファイルで構成することも、実行時にプログラムで構成することもできます。

デフォルトのロガー

google_ads_config.rb ファイルで log_level フィールドと log_target フィールドを指定して、デフォルトのロガーを設定します。

Google::Ads::GoogleAds::Config.new do |c|
  # Valid levels: 'DEBUG', 'INFO', 'WARN', 'ERROR', 'FATAL'
  c.log_level = 'INFO'

  # Output destination, such as STDOUT, STDERR, or a file path
  c.log_target = STDOUT
end

カスタム ロガー

logger フィールドを使用して、独自のカスタム Ruby Logger インスタンスを指定することもできます。logger を指定すると、log_level と log_target は無視されます。

require 'logger'

# In google_ads_config.rb:
Google::Ads::GoogleAds::Config.new do |c|
  c.logger = Logger.new('log/google_ads.log')
end

client.logger= を使用してクライアントをインスタンス化した後に、カスタム ロガーを割り当てることもできます。これは、client.logger が設定された後に取得されたサービス クライアント（client.service.<name>）にのみ適用されます。

require 'logger'

client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.logger = Logger.new(STDOUT)