Solicitações, respostas e mensagens de resumo feitas na Google Ads API podem ser registradas com seu logger personalizado ou com o logger padrão na biblioteca de cliente para Perl.
Níveis de registro
A biblioteca registra diferentes tipos de eventos em diferentes níveis de registro. Em uma resposta bem-sucedida da API, 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 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 |
No caso de falhas parciais, os detalhes delas serã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 por meio do módulo GoogleAdsLogger. Essa classe oferece uma configuração padrão que os registradores de resumo e de detalhes
registrarão 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 registradores.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();Desativa a geração de registros de resumo.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();Desativa o registro de detalhes.
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.