La biblioteca cliente de Python está alojada en GitHub y el paquete está disponible en PyPI.
Requisitos
La biblioteca admite Python 3.9 a 3.14 (>=3.9, <3.15; la compatibilidad con Python 3.14 se agregó en v28.2.0). Debido a que Python 3.9 y 3.10 emiten una advertencia de obsolescencia en la importación en google-ads v32.0.0 y versiones posteriores, se recomienda usar Python 3.11 o versiones posteriores.
Requisitos previos
Antes de continuar con esta guía, necesitas el ID de cliente de 10 dígitos de tu cuenta de Google Ads.
Compatibilidad de dependencias y entorno de ejecución
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 para las versiones con el estado "feature" o "prerelease".
El equipo de la API de Google Ads tiene como objetivo adoptar nuevas versiones del entorno de ejecución de Python tan pronto como se lancen y sean compatibles oficialmente con la Python Software Foundation.
Los entornos de ejecución de Python que alcanzaron el final del ciclo de vida (EOL) no se admiten después de la fecha de EOL que se indica en la sección Unsupported Versions de python.org. No se puede garantizar la compatibilidad con los tiempos de ejecución de EOL, ya que las versiones de la biblioteca posteriores a una fecha de EOL pueden interrumpir la compatibilidad.
En el caso de las dependencias (específicamente, cualquier paquete que mantenga Google y que la biblioteca cliente de Python enumere como obligatorio), se mantiene 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 la guía de instalación, se describen todas las formas diferentes 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
Después de instalar la biblioteca, debes configurarla. Existen varias formas de configurar la biblioteca, que se describen en la guía de configuración.
Autenticación
Una vez que hayas elegido un enfoque de configuración, establece la configuración de autenticación. Para obtener instrucciones paso a paso, consulta la guía de autenticación de la biblioteca cliente de Python. Para obtener información general, consulta la descripción general 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 probar rápidamente que la biblioteca esté configurada correctamente para realizar solicitudes a la API.
Para ejecutar la muestra de get_campaigns.py, primero clona el repositorio de google-ads-python. Luego, desde el directorio raíz del repositorio clonado, ejecuta el siguiente comando:
python examples/basic_operations/get_campaigns.py -c INSERT_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: