Ativar a geração de registros

É possível registrar solicitações, respostas e mensagens de resumo enviadas à API Google Ads usando o registrador padrão na biblioteca de cliente Ruby ou seu próprio registrador Ruby personalizado. Se nenhuma configuração de geração de registros for fornecida, a geração de registros 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 durante a 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 gravador de registros personalizado depois de instanciar o cliente usando client.logger=. Observação: isso só entra em vigor em 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)