Logging

As solicitações, respostas e mensagens de resumo feitas para a 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 registra diferentes tipos de eventos em diferentes níveis de registro. Em uma resposta da API bem-sucedida, o resumo é registrado em INFO, e a solicitação e a resposta completas são registradas em DEBUG. Em uma solicitação que resulta em um erro de API, a mensagem de resumo é registrada em WARN, e a solicitação e a resposta completas sã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

Para falhas parciais, os detalhes são registrados no logger DETAIL em DEBUG.

Configuração

A biblioteca de cliente usa uma classe personalizada para todos os fins de geração de registros e é exposta pelo módulo GoogleAdsLogger. Essa classe fornece uma configuração padrão em que os registradores de resumo e de detalhes gravam em arquivos na pasta logs no diretório HOME.

Personalizar a configuração do Log4perl

É possível modificar a configuração padrão fornecendo um arquivo log4perl.conf personalizado 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 de forma programática usando os seguintes métodos auxiliares:

• Ative a geração de registros para os dois registradores (transmita 1 para definir o nível como DEBUG para que os payloads completos de solicitação e resposta sejam registrados para chamadas bem-sucedidas):

  use Google::Ads::GoogleAds::Logging::GoogleAdsLogger;
  
  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);
  

• Desativar todos os 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 detalhados:

  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.