Registro
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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 registrará diferentes tipos de eventos en diferentes niveles de registro. En una respuesta exitosa de la API, el resumen se registrará en INFO, y la solicitud y las respuestas completas se registrarán en DEBUG. En una solicitud que generó un error de API, el mensaje de resumen se registrará en WARN, y la solicitud y la respuesta completas se registrarán 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 fallas parciales, los detalles de la falla parcial se registrarán 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 registrarán en archivos relativos en la carpeta logs en tu directorio HOME.
Sin embargo, la configuración predeterminada se puede anular si proporcionas un archivo log4perl.conf en tu directorio HOME.
El registro se puede habilitar o inhabilitar con los siguientes métodos:
Habilita el registro para ambos registradores.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_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.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-27 (UTC)
[null,null,["Última actualización: 2025-08-27 (UTC)"],[[["\u003cp\u003eThe Google Ads API client library for Perl allows logging of requests, responses, and summaries using a custom or default logger.\u003c/p\u003e\n"],["\u003cp\u003eLogging levels include \u003ccode\u003eINFO\u003c/code\u003e, \u003ccode\u003eDEBUG\u003c/code\u003e, and \u003ccode\u003eWARN\u003c/code\u003e, used to categorize different event types like successes, failures, and partial failures.\u003c/p\u003e\n"],["\u003cp\u003eThe default logger configuration saves logs to the \u003ccode\u003elogs\u003c/code\u003e folder in your home directory, which can be customized by providing a \u003ccode\u003elog4perl.conf\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eLogging can be controlled through the \u003ccode\u003eGoogleAdsLogger\u003c/code\u003e module, allowing for enabling/disabling logging or more advanced customization.\u003c/p\u003e\n"]]],[],null,["# Logging\n\nRequests, responses, and summary messages made to the Google Ads API can be\nlogged with your own custom logger or the default logger in the client library\nfor Perl.\n\nLog Levels\n----------\n\nThe library will log different types of events to different log levels. On a\nsuccessful API response, the summary will be logged at `INFO`, and the full\nrequest and responses will be logged at `DEBUG`. On a request that resulted in\nan API error, the summary message will be logged at `WARN` and the full request\nand response will be logged at `INFO`.\n\n| Log type | Log name | Success level | Failure level |\n|----------|------------------------------|---------------|---------------|\n| SUMMARY | Google.Ads.GoogleAds.Summary | INFO | WARN |\n| DETAIL | Google.Ads.GoogleAds.Detail | DEBUG | INFO |\n\nFor partial failures, the partial failure details will be logged at `DEBUG`.\n\nConfiguration\n-------------\n\nThe client library uses a custom class for all logging purposes and is exposed\nthrough the [GoogleAdsLogger](https://github.com/googleads/google-ads-perl/blob/HEAD/lib/Google/Ads/GoogleAds/Logging/GoogleAdsLogger.pm)\nmodule. This class provides a default configuration that both summary and detail\nloggers will log to relative files in the `logs` folder under your `HOME` directory.\nBut the default configuration can be overridden by providing a\n[log4perl.conf](https://github.com/googleads/google-ads-perl/blob/HEAD/log4perl.conf)\nfile in your `HOME` directory.\n\nLogging can be enabled/disabled using the following methods:\n\n- Enables logging for both loggers.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();\n\n- Disables the summary logging.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();\n\n- Disables the detail logging.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();\n\nYou can use the methods of the `GoogleAdsLogger` class directly for even more\ncontrol over how requests are logged."]]
