A biblioteca pode ser configurada para registrar interações com a API Google Ads de várias maneiras. Registre solicitações e respostas detalhadas, além de mensagens de resumo mais concisas. Essas configurações são gerenciadas pela configuração da biblioteca de cliente. Confira abaixo detalhes sobre os diferentes tipos de opções de configuração disponíveis.
A biblioteca usa o framework de geração de registros
integrado do Python e os registros para stderr por padrão. Se incluído, o objeto logging
definido na configuração é transmitido diretamente para
logging.config.dictConfig
como um dict.
Também é possível configurar a geração de registros de maneira programática definindo uma configuração de geração de registros antes de inicializar o cliente. É possível recuperar a instância do logger do cliente e configurá-la 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. Todas as alterações subsequentes na configuração da geração de registros serão ignoradas. Para modificar programaticamente a configuração de 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 é possível definir sua configuração para ver alguns ou todos os itens abaixo:
| Nível | Solicitação bem-sucedida | Falha na solicitação |
|---|---|---|
DEBUG |
Um registro detalhado com objetos completos de solicitação e resposta como JSON. | Um registro detalhado com objetos completos de solicitação e exceção como JSON. |
INFO |
Um resumo conciso com campos específicos de solicitação e resposta. | Um registro detalhado com objetos completos de solicitação e exceção como JSON. |
WARNING |
Nenhum | Um resumo conciso com informações específicas da solicitação, o estado da exceção e a mensagem. |
Como o framework de geração de registros do Python ignora mensagens de registro menos graves do que o nível configurado, definir como WARNING significa que você verá apenas mensagens concisas relacionadas a solicitações com falha, mas definir como DEBUG significa que serão exibidos 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 o exemplo get_campaigns:
python get_campaigns.py -c $CLIENT_ID 2> example.log
Como gerar registros de interceptadores
A biblioteca de cliente Python usa interceptores gRPC para acessar e registrar detalhes de solicitação e resposta. É possível configurar sua própria geração de registros personalizada criando um interceptador gRPC com lógica personalizada. Consulte o guia do Logging para ver mais detalhes e um exemplo de um interceptador da geração de registros personalizado.