Logging

Solicitações, respostas e mensagens de resumo feitas à API Google Ads podem ser registrados com seu próprio registrador personalizado ou o 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 um bem-sucedida da API, o resumo será registrado em INFO, e o e as respostas 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 completa e a resposta será registrada 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 registro em log e é exposta por meio do GoogleAdsLogger mais tarde neste módulo. Essa classe fornece uma configuração padrão que tanto os elementos de resumo os loggers vão registrar arquivos relativos na pasta logs no diretório HOME. Mas a configuração padrão pode ser substituída por uma 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 de como as solicitações são registradas.