Las solicitudes, las respuestas y los mensajes de resumen que se realizan a la API de Google Ads se pueden registrar con tu propio registrador personalizado o con el registrador predeterminado de la biblioteca cliente para Perl.
Niveles de registro
La biblioteca registra diferentes tipos de eventos en distintos niveles de registro. En una
respuesta de la API correcta, 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 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 de tu directorio HOME.
Personaliza la configuración de Log4perl
Puedes anular la configuración predeterminada si proporcionas un archivo
log4perl.conf personalizado en el directorio HOME o si
inicializas Log::Log4perl directamente en la aplicación antes de realizar llamadas a la
API.
Habilita o inhabilita los registros
El registro se puede habilitar o inhabilitar de manera 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 solicitudes y respuestas 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.