As solicitações, respostas e mensagens de resumo feitas para a API Google Ads podem ser registradas com seu próprio registrador personalizado ou o registrador 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
completa e as respostas 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 a 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 serão registrados em DEBUG.
Configuração
A biblioteca de cliente usa uma classe personalizada para todos os fins de geração de registros e é exposta
pelo módulo GoogleAdsLogger. Essa classe fornece uma configuração padrão que os registradores de resumo e
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.
A geração de registros pode ser ativada/desativada 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();
É possível usar os métodos da classe GoogleAdsLogger diretamente para ter ainda mais
controle sobre como as solicitações são registradas.