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 entorno de ejecución y dependencias
La biblioteca cliente de Python mantiene la compatibilidad con los entornos de ejecución de Python en la sección Versiones compatibles que publica la Python Software Foundation, excepto las versiones con el estado "feature" o "prerelease".
Nuestro objetivo es adoptar las versiones nuevas 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 llegaron al 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 podemos garantizar la compatibilidad con los entornos de ejecución de EOL, ya que podemos lanzar una versión de la biblioteca que no sea compatible con ellos en cualquier momento después de su fecha de EOL.
En cuanto a las dependencias (específicamente, cualquier paquete mantenido por Google que se indique como obligatorio para la biblioteca cliente de Python), mantendremos la compatibilidad con los paquetes que Google mantenga y que se consideren "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
Nuestra guía de instalación muestra 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
Una vez que hayas instalado la biblioteca, deberás configurar 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 elijas un enfoque de configuración, podrás configurar la 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 nuestra 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 get_campaigns.py, en el directorio raíz de la biblioteca cliente 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: