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 estos parámetros. A continuación, se incluyen detalles sobre los diferentes tipos de opciones de configuración disponibles.
La biblioteca usa el framework de registro integrado de Python y se registra en stderr de forma predeterminada. 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 forma 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 registrador de clientes se configura cuando se inicializa el cliente. Se ignorarán todos los cambios posteriores en la configuración de registro. Para anular de forma 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 varios niveles diferentes, y puedes configurarlo para ver algunos o todos los siguientes:
| 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 la solicitud completa y los objetos de excepción como JSON. |
INFO |
Un resumen conciso con campos de solicitud y respuesta específicos | Un registro detallado con la solicitud completa y los objetos de excepción como JSON. |
WARNING |
Ninguno | Un resumen conciso con información específica de la solicitud, el estado y el mensaje de la excepción. |
Dado que el framework de registro de Python ignora los mensajes de registro que son menos graves que el nivel configurado, si estableces el valor en WARNING, solo verás mensajes concisos relacionados con las solicitudes fallidas, pero si estableces el valor en DEBUG, verás todos los tipos de registros posibles en la tabla anterior.
Registro en un archivo
Puedes canalizar mensajes de registro a un archivo con facilidad, por ejemplo, cuando ejecutas el ejemplo de get_campaigns:
python get_campaigns.py -c $CLIENT_ID 2> example.log
Interceptores de registro
La biblioteca cliente de Python usa interceptores de gRPC para acceder a los detalles de las solicitudes y respuestas, y registrarlos. Para configurar tu propio registro personalizado, crea 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.