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.