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.