Ativar a geração de registros

É possível registrar solicitações, respostas e mensagens de resumo enviadas à API Google Ads usando o logger padrão na biblioteca de cliente do Ruby ou seu próprio logger personalizado do Ruby. Se nenhuma configuração de geração de registros for fornecida, ela será desativada por padrão.

Níveis de registro

A biblioteca registra eventos em diferentes níveis de registro, dependendo do resultado da solicitação de API:

Configuração

É possível configurar a geração de registros no arquivo de configuração google_ads_config.rb ou de maneira programática no ambiente de execução.

Registrador padrão

Configure o registrador padrão especificando os campos log_level e log_target no arquivo 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

Registrador personalizado

Também é possível especificar sua própria instância personalizada do Ruby Logger usando o campo logger. Se você especificar logger, log_level e log_target serão ignorados:

require 'logger'

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

Também é possível atribuir um logger personalizado depois de instanciar o cliente usando client.logger=. Isso só entra em vigor nos clientes de serviço buscados (client.service.<name>) depois que client.logger é definido:

require 'logger'

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