Включить ведение журнала

Вы можете регистрировать запросы, ответы и сводные сообщения, отправляемые в Google Ads API, используя регистратор по умолчанию в клиентской библиотеке Ruby или собственный регистратор Ruby. Если конфигурация ведения журналов не задана, по умолчанию ведение журналов отключено.

Уровни журналов

Библиотека регистрирует события на разных уровнях журнала в зависимости от результата запроса к API:

Конфигурация

Вы можете настроить ведение журнала в файле конфигурации google_ads_config.rb или программно во время выполнения.

Регистратор по умолчанию

Настройте регистратор по умолчанию, указав поля log_level и log_target в файле google_ads_config.rb:

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

Собственный регистратор

Вы также можете указать собственный экземпляр Ruby Logger, используя поле 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.service.<name>) после установки client.logger:

require 'logger'

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