Geração de registros

A biblioteca pode ser configurada para registrar interações com a API Google Ads no de várias maneiras. Você pode registrar solicitações e respostas detalhadas, como bem como mensagens de resumo mais concisas. Essas configurações são gerenciadas pela configuração da biblioteca de cliente. Confira abaixo os detalhes diferentes tipos de opções de configuração disponíveis.

A biblioteca usa a geração de registros integrada do Python framework e registros para stderr por padrão. Se incluído, o objeto logging definido em sua configuração é passado diretamente para logging.config.dictConfig como um dict.

Também é possível configurar a geração de registros de maneira programática definindo um antes de inicializar o cliente. É possível recuperar o cliente de geração de registros e configure-a com o seguinte exemplo:

import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)

O registrador de clientes é configurado quando o cliente é inicializado. Qualquer um as mudanças subsequentes na configuração da geração de registros serão ignoradas. Para substituir programaticamente a configuração da geração de registros no arquivo YAML, chame as linhas acima antes de o cliente ser inicializado.

Níveis de registro

O cliente gera registros em alguns níveis diferentes, e você pode configurar para ver alguns ou todos os itens abaixo:

Como o framework de geração de registros do Python ignora mensagens de registro menos graves, que o nível configurado, definir como WARNING significa que você só verá mensagens concisas relacionadas a solicitações com falha, mas definir como DEBUG significa vão aparecer todos os tipos possíveis de registros na tabela acima.

Registrando para arquivo

É fácil direcionar mensagens de registro para um arquivo. por exemplo, ao executar Exemplo de get_campaigns:

python get_campaigns.py -c $CLIENT_ID 2> example.log

Como gerar registros de interceptadores

A biblioteca de cliente Python usa gRPC interceptors para acessar e registrar a solicitação e os detalhes da resposta. É possível configurar sua própria geração de registros personalizada criando um gRPC com lógica personalizada. Consulte a seção Geração de registros guia para mais detalhes e um exemplo de um interceptador da geração de registros personalizado.