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 registra diferentes tipos de eventos em níveis de registro diferentes. Em uma resposta bem-sucedida da API, o resumo é registrado como INFO, e a solicitação e resposta completas são registradas como DEBUG. Em uma solicitação que resulta em um erro de API, a mensagem de resumo é registrada como WARN, e a solicitação e resposta completas são registradas como 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 no logger DETAIL como DEBUG.
Configuração
A biblioteca de cliente usa uma classe personalizada para todas as finalidades de registro e é exposta
pelo GoogleAdsLogger módulo. Essa classe fornece uma configuração padrão em que os loggers de resumo e detalhes gravam arquivos na pasta logs no diretório HOME.
Personalizar a configuração do Log4perl
É possível substituir a configuração padrão fornecendo um
log4perl.conf arquivo no diretório HOME ou inicializando
Log::Log4perl diretamente no aplicativo antes de fazer chamadas de API.
Ativar ou desativar registros
A geração de registros pode ser ativada ou desativada programaticamente usando os seguintes métodos auxiliares:
Ativar a geração de registros para os dois loggers (transmita
1para definir o nível comoDEBUG, de modo que as cargas úteis de solicitação e resposta completas sejam registradas para chamadas bem-sucedidas):use Google::Ads::GoogleAds::Logging::GoogleAdsLogger; Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);Desativar toda a geração de registros:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();Desativar a geração de registros de resumo:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();Desativar a geração de registros de detalhes:
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.