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; se agregó compatibilidad con Python 3.14
en v28.2.0). Debido a que Python 3.9 y 3.10 emiten una advertencia de baja
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 con el entorno de ejecución y las dependencias
La biblioteca cliente de Python mantiene la compatibilidad con los entornos de ejecución de Python en la sección Versiones compatibles publicada por Python Software Foundation, excepto 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 en cuanto se publiquen y sean compatibles oficialmente con Python Software Foundation.
Los entornos de ejecución de Python que alcanzaron el final del ciclo de vida (EOL) no son compatibles después de la fecha de EOL en la sección Versiones no compatibles de python.org. No se puede garantizar la compatibilidad con los entornos de ejecución de EOL, ya que las versiones de la biblioteca después de una fecha de EOL pueden interrumpir la compatibilidad.
En cuanto a las dependencias (específicamente, cualquier paquete mantenido por Google que se indique como obligatorio para la biblioteca cliente de Python), se mantiene la compatibilidad con los paquetes que Google mantiene y que se consideran "compatibles" según la Política de cambios rotundos 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 Dependencias.
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 configurar una configuración para ella. Existen varias formas de configurar la biblioteca, que se describen en la guía de configuración.
Autenticación
Una vez que elijas un enfoque de configuración, configura la 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 configures 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 get_campaigns.py, primero clona el
google-ads-python repositorio. 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: