La biblioteca se puede configurar para registrar interacciones con la API de Google Ads en de varias maneras. Puedes registrar solicitudes y respuestas detalladas, como así como mensajes de resumen más concisos. El administrador administra estos parámetros de configuración la configuración de la biblioteca cliente. A continuación, se incluyen detalles diferentes tipos de opciones de configuración disponibles.
La biblioteca usa los registros integrados de Python
el framework y los registros en stderr de forma predeterminada. Si se incluye, el objeto logging
definidos en tu configuración se pasan directamente
logging.config.dictConfig
como dict.
También puedes configurar el registro de manera programática estableciendo un antes de inicializar el cliente. Puedes recuperar el cliente de registro y configúrala 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. Cualquiera los cambios posteriores a la configuración de registro se ignorarán. Para de manera programática la configuración de registro en el archivo YAML, asegúrate de llama a las líneas anteriores antes de que se inicialice el cliente.
Niveles de registro
El cliente genera registros en diferentes niveles y puedes configurar de Terraform para ver algunos de los siguientes datos o todos ellos:
| 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 establecer el valor en DEBUG significa
verás todos los tipos de registros posibles en la tabla anterior.
Accede al archivo
Puedes canalizar fácilmente los mensajes de registro a un archivo; por ejemplo, cuando ejecutes el
Ejemplo de get_campaigns:
python get_campaigns.py -c $CLIENT_ID 2> example.log
Interceptores de registros
La biblioteca cliente de Python usa gRPC interceptores para acceder y registrar la solicitud y los detalles de las respuestas. Puedes configurar tu propio registro personalizado creando un gRPC con una lógica personalizada. Consulta la documentación de Registro guía para obtener más información y un ejemplo de un interceptor de registro personalizado.