Solicitações, respostas e mensagens de resumo feitas à API Google Ads podem ser registradas com seu próprio logger personalizado ou o logger padrão na biblioteca de cliente para Perl.
Níveis de registro
A biblioteca 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 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 serão registrados em DEBUG
.
Configuração
A biblioteca de cliente usa uma classe personalizada para todos os fins de registro e é exposta por meio do módulo GoogleAdsLogger. Essa classe fornece uma configuração padrão que os loggers de resumo e de detalhes
registrarão em arquivos relativos na pasta logs
no diretório HOME
.
Mas 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 ou desativada usando os seguintes métodos:
Ativa a geração de registros para ambos os loggers.
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 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.