La biblioteca cliente de Python está alojada en GitHub, y el paquete está disponible en PyPI.
Requisitos
La biblioteca requiere Python 3.9 o versiones posteriores.
Requisitos previos
Antes de continuar con esta guía, necesitarás un token de desarrollador para la API de Google Ads y el ID de cliente de 10 dígitos de tu cuenta de Google Ads.
Compatibilidad de tiempo de ejecución y dependencias
La biblioteca cliente de Python mantiene la compatibilidad con los tiempos de ejecución de Python en la sección Supported Versions publicada por la Python Software Foundation, excepto las versiones con el estado "feature" o "prerelease".
Nuestro objetivo es adoptar las nuevas versiones del entorno de ejecución de Python en cuanto se lancen y sean compatibles oficialmente con la Python Software Foundation.
Los tiempos de ejecución de Python que alcanzaron el final del ciclo de vida (EOL) no se admiten después de la fecha de EOL en la sección Versiones no admitidas de python.org. No podemos garantizar la compatibilidad con los tiempos de ejecución que llegaron al final de su ciclo de vida, ya que es posible que lancemos una versión de la biblioteca que sea incompatible con ellos en cualquier momento después de la fecha de finalización de su ciclo de vida.
En el caso de las dependencias (específicamente, los paquetes que mantiene Google y que la biblioteca cliente de Python enumera como obligatorios), mantendremos la compatibilidad con los paquetes que mantiene Google y que se consideran "compatibles" según la Política de Cambios Incompatibles de OSS de Google.
Para obtener una lista completa de los entornos de ejecución y las dependencias de Python compatibles, consulta la página Dependencies.
Instalación
En nuestra guía de instalación, se muestran todas las formas de instalar la biblioteca. La forma más sencilla (y recomendada) de instalar la biblioteca en tu aplicación es con pip:
$ python -m pip install google-ads
Configuración
Una vez que hayas instalado la biblioteca, deberás establecer una configuración para ella. Existen varias formas de configurar la biblioteca, que se describen en nuestra guía de configuración.
Autenticación
Una vez que hayas elegido un enfoque de configuración, podrás establecer la configuración de autenticación. Para obtener instrucciones paso a paso, consulta nuestra guía de autenticación de la biblioteca cliente de Python y, para obtener información general, consulta nuestro resumen de OAuth.
Realiza una solicitud a la API
Una vez que hayas configurado la autenticación, podrás realizar una solicitud a la API. Consulta el ejemplo de obtener campañas para ver una forma rápida de probar que la biblioteca esté configurada correctamente para realizar solicitudes a la API.
Para ejecutar la muestra de get_campaigns.py, en el directorio raíz de la biblioteca cliente de googleads-python instalada de forma local, ejecuta el siguiente comando:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
Recursos adicionales
Después de que puedas realizar una solicitud a la API, continúa con estos usos de la biblioteca cliente: