Las solicitudes, las respuestas y los mensajes de resumen que se envían a la API de Google Ads se pueden registrar con tu propio registrador personalizado o con el registrador predeterminado de la biblioteca cliente de Perl.
Niveles de registro
La biblioteca registra diferentes tipos de eventos en diferentes niveles de registro. En una respuesta exitosa de la API, el resumen se registra en INFO, y la solicitud y la respuesta completas se registran en DEBUG. En una solicitud que genera un error de API, el mensaje de resumen se registra en WARN y la solicitud y la respuesta completas se registran en INFO.
| Tipo de registro | Nombre del registro | Nivel de éxito | Nivel de falla |
|---|---|---|---|
| RESUMEN | Google.Ads.GoogleAds.Summary | INFORMACIÓN | WARN |
| DETALLE | Google.Ads.GoogleAds.Detail | DEBUG | INFORMACIÓN |
En el caso de las fallas parciales, los detalles de la falla parcial se registran en el registrador DETAIL en DEBUG.
Configuración
La biblioteca cliente usa una clase personalizada para todos los fines de registro y se expone a través del módulo GoogleAdsLogger. Esta clase proporciona una configuración predeterminada en la que los registradores de resumen y de detalles escriben en archivos de la carpeta logs en tu directorio HOME.
Personaliza la configuración de Log4perl
Puedes anular la configuración predeterminada proporcionando un archivo log4perl.conf personalizado en tu directorio HOME o inicializando Log::Log4perl directamente en tu aplicación antes de realizar llamadas a la API.
Cómo habilitar o inhabilitar los registros
El registro se puede habilitar o inhabilitar de forma programática con los siguientes métodos auxiliares:
Habilita el registro para ambos registradores (pasa
1para establecer el nivel enDEBUG, de modo que se registren las cargas útiles completas de solicitud y respuesta para las llamadas exitosas):use Google::Ads::GoogleAds::Logging::GoogleAdsLogger; Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);Inhabilita todos los registros:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();Inhabilita el registro de resúmenes:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();Inhabilita el registro de detalles:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
Puedes usar los métodos de la clase GoogleAdsLogger directamente para tener aún más control sobre cómo se registran las solicitudes.