Geração de registros

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.