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 de Ruby personalizado. Si no se proporciona una configuración de registro, este 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 la API | WARN |
INFO |
| Falla parcial | Ninguno | DEBUG (detalles de la falla parcial) |
Configuración
Puedes configurar el registro en el archivo de configuración google_ads_config.rb
o de manera programática en el entorno 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 se aplica a 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)