Registro

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

La biblioteca utiliza el framework de logging integrado de Python y los registros 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 manera programática si estableces una configuración de registro antes de inicializar el cliente. Puedes recuperar la instancia del registrador de 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 del cliente se configura cuando se inicializa el cliente. Se ignorará cualquier cambio posterior en la configuración de registro. Para 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 diferentes niveles y puedes establecer la configuración para ver todos o algunos de los siguientes elementos:

Nivel Solicitud correcta Se produjo un error en la solicitud
DEBUG Un registro detallado con objetos Request y Response completos como JSON. Un registro detallado con objetos de solicitud y excepción completos como JSON.
INFO Un resumen conciso con campos específicos de solicitud y respuesta. Un registro detallado con objetos de solicitud y excepción completos como JSON.
WARNING Ninguno Un resumen conciso con la información específica de la solicitud, el estado de 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, establecer en WARNING significa que solo verás mensajes concisos relacionados con las solicitudes con errores. La configuración en DEBUG significa que verás todos los tipos de registros posibles en la tabla anterior.

Registro en archivo

Puedes canalizar mensajes de registro con facilidad a un archivo, 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 y registrar los detalles de solicitud y respuesta. Para configurar tu propio registro personalizado, crea un interceptor de gRPC con una lógica personalizada. Consulta la guía de Logging para obtener más detalles y un ejemplo de un interceptor de registro personalizado.