ロギングを有効にする

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

ログレベル

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

構成

ロギングは、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)