Registro

La biblioteca se puede configurar para registrar interacciones con la API de Google Ads de varias maneras. Puedes registrar solicitudes y respuestas detalladas, así como mensajes de resumen más concisos. La configuración de la biblioteca cliente administra la configuración. A continuación, se detallan los diferentes tipos de opciones de configuración disponibles.

De forma predeterminada, la biblioteca usa el framework logging integrado de Python y los registros en stderr. Si se incluye, el objeto logging definido en tu configuración se pasa directamente a logging.config.dictConfig como dict.

También puedes configurar el registro de manera programática si estableces una configuración de registro antes de inicializar el cliente. Puedes recuperar la instancia del registrador del cliente y configurarla con el siguiente ejemplo:

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

Ten en cuenta que el registro del cliente se configura cuando se inicializa el cliente. Se ignorará cualquier cambio posterior que se realice en la configuración de registros. A fin de anular de manera programática la configuración de registro en el archivo YAML, asegúrate de llamar a las líneas anteriores antes de que se inicialice el cliente.

Niveles de registro

El cliente genera registros en algunos niveles diferentes, y puedes establecer la configuración para ver algunos o todos los siguientes valores:

Nivel Solicitud correcta Se produjo un error en la solicitud
DEBUG Un registro detallado con objetos de solicitud y respuesta completos como JSON. Un registro detallado con solicitud completa y objetos de excepción como JSON.
INFO Un resumen conciso con campos específicos de solicitud y respuesta Un registro detallado con solicitud completa y objetos de excepción como JSON.
WARNING Ninguno Un resumen conciso con información de solicitud específica, el estado de la excepción y el mensaje.

Dado que el framework de registro de Python ignora los mensajes de registro que son menos graves que el nivel configurado, establecerlo en WARNING implica que solo verás mensajes concisos relacionados con solicitudes fallidas, pero establecerlo en DEBUG significa que verás todos los tipos posibles de registros en la tabla anterior.

Accediendo al archivo

Puedes canalizar con facilidad los mensajes de registro a un archivo; por ejemplo, cuando ejecutas el ejemplo de get_campaigns:

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

Interceptores de registros

La biblioteca cliente de Python usa los interceptores de gRPC para acceder a los detalles de solicitud y respuesta y registrarlos. Puedes configurar tu propio registro personalizado si creas un interceptor de gRPC con lógica personalizada. Consulta la Guía de registro para obtener más detalles y un ejemplo de un interceptor de registro personalizado.