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 ajustes. A continuación, se muestran los detalles de los diferentes tipos de opciones de configuración que están disponibles.
La biblioteca usa 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 establecer 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 clientes 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á 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 algunos niveles diferentes y puedes definir tu configuración 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 en formato JSON. | Un registro detallado con objetos completos de solicitud y excepción en formato JSON. |
INFO |
Un resumen conciso con campos específicos de solicitud y respuesta. | Un registro detallado con objetos completos de solicitud y excepción en formato JSON. |
WARNING |
Ninguno | Resumen conciso con 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, si se establece en WARNING, solo verás mensajes concisos relacionados con solicitudes fallidas, pero si se establece en DEBUG, verás todos los tipos de registros posibles en la tabla anterior.
Accede 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 interceptores de gRPC para acceder y registrar los detalles de la solicitud y la respuesta. Puedes configurar tu propio registro personalizado si creas 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.