Habilitar registro

Puedes registrar las solicitudes, las respuestas y los mensajes de resumen que se envían a la API de Google Ads con el registrador predeterminado de la biblioteca cliente de Ruby o con tu propio registrador personalizado de Ruby. Si no se proporciona ninguna configuración de registro, el registro se inhabilita de forma predeterminada.

Niveles de registro

La biblioteca registra eventos en diferentes niveles de registro según el resultado de la solicitud a la API:

Tipo de evento Nivel de registro de resumen Nivel de registro completo de solicitudes y respuestas
Respuesta correcta de la API INFO DEBUG
Error de API WARN INFO
Falla parcial Ninguno DEBUG (detalles de errores parciales)

Configuración

Puedes configurar el registro en tu archivo de configuración google_ads_config.rb o de forma programática en el tiempo de ejecución.

Registrador predeterminado

Configura el registrador predeterminado especificando los campos log_level y log_target en tu archivo 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

También puedes especificar tu propia instancia de Ruby Logger personalizada con el campo logger. Si especificas logger, se ignoran log_level y 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

También puedes asignar un registrador personalizado después de crear una instancia del cliente con client.logger=. Ten en cuenta que esto solo tiene efecto en los clientes de servicio recuperados (client.service.<name>) después de que se establece client.logger:

require 'logger'

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