Logging
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
As solicitações, respostas e mensagens de resumo feitas para a API Google Ads podem ser
registradas com seu próprio logger personalizado ou com o logger padrão na biblioteca de cliente
para Perl.
Níveis de registro
A biblioteca vai registrar diferentes tipos de eventos em diferentes níveis de registro. Em uma resposta de API bem-sucedida, o resumo será registrado em INFO, e a solicitação e as respostas completas serão registradas em DEBUG. Em uma solicitação que resultou em um erro de API, a mensagem de resumo será registrada em WARN, e a solicitação e resposta completas serão registradas em INFO.
| Tipo de registro |
Nome do registro |
Nível de sucesso |
Nível de falha |
| RESUMO |
Google.Ads.GoogleAds.Summary |
INFO |
WARN |
| DETALHE |
Google.Ads.GoogleAds.Detail |
DEBUG |
INFO |
Para falhas parciais, os detalhes são registrados em DEBUG.
Configuração
A biblioteca de cliente usa uma classe personalizada para todas as finalidades de geração de registros e é exposta pelo módulo GoogleAdsLogger. Essa classe fornece uma configuração padrão que os gravadores de registros de resumo e de detalhes vão registrar em arquivos relativos na pasta logs no diretório HOME.
No entanto, a configuração padrão pode ser substituída fornecendo um
arquivo log4perl.conf
no diretório HOME.
É possível ativar/desativar a geração de registros usando os seguintes métodos:
Ativa a geração de registros para os dois loggers.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
Desativa o registro de resumo.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
Desativa o registro detalhado.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
Você pode usar os métodos da classe GoogleAdsLogger diretamente para ter ainda mais controle sobre como as solicitações são registradas.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-27 UTC.
[null,null,["Última atualização 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."]]
