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.