La biblioteca cliente de Python se aloja 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 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 final 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 la Python Software Foundation, excepto para las versiones con un estado de "función" o "versión preliminar".
El equipo de la API de Google Ads tiene como objetivo adoptar las nuevas versiones del entorno de ejecución de Python en cuanto se lancen y cuenten con la asistencia oficial de 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 que llegaron al final de su ciclo de vida, ya que las versiones de la biblioteca posteriores a la fecha de finalización del ciclo de vida pueden romper la compatibilidad.
En el caso de las dependencias (específicamente, cualquier paquete mantenido por Google que la biblioteca cliente de Python enumere como obligatorio), la compatibilidad se mantiene con los paquetes que mantiene Google y que se consideran "compatibles" de acuerdo con 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 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 establecer 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 hayas elegido un enfoque de configuración, establece tu 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 más información general, consulta la descripción general de OAuth.
Realiza una solicitud a la API
Una vez que hayas establecido la configuración de autenticación, podrás realizar una solicitud a la API. Consulta el ejemplo de obtención de 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, 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: