Instalación

Ya sea que instales la biblioteca desde PyPI o la clones desde GitHub, realiza los siguientes pasos con un entorno virtual activo. Para obtener información sobre cómo crear y activar un entorno virtual, consulta la documentación de Entorno virtual.

Para crear y activar rápidamente un entorno virtual, haz lo siguiente:

python3 -m venv env
source env/bin/activate

Instala el módulo desde PyPI

La biblioteca se distribuye en PyPI y se puede instalar con pip con el siguiente comando:

python -m pip install google-ads

Verifica la instalación

Verifica que el módulo se haya instalado correctamente:

python -c "import google.ads.googleads"

Instala la biblioteca desde GitHub

El código fuente de la biblioteca se puede clonar desde GitHub en tu máquina local. Clonar el código fuente es útil para ejecutar los ejemplos o desarrollar la biblioteca. Como referencia, ejecutar uno de los ejemplos de autenticación es un paso obligatorio para configurar la biblioteca para su uso.

  1. Asegúrate de que haya una versión de Python compatible (de Python 3.9 a 3.14; se recomienda Python 3.11 o versiones posteriores) en tu entorno. La forma más sencilla es usar pyenv:

    pyenv install 3.13
pyenv local 3.13

  2. Clona la biblioteca cliente desde GitHub:

    git clone https://github.com/googleads/google-ads-python.git

  3. Ingresa al repositorio y, luego, instálalo en modo editable:

    cd google-ads-python
python -m pip install -e .

  4. Si planeas desarrollar la biblioteca, ejecuta las pruebas de unidades antes y después de realizar cualquier cambio:

    1. Asegúrate de tener todas las versiones compatibles del lenguaje Python disponibles en tu entorno con pyenv:

      pyenv local 3.9 3.10 3.11 3.12 3.13 3.14

    2. Instala las dependencias específicas de la prueba de la biblioteca:

      python -m pip install -e ".[tests]"

    3. Ejecuta las pruebas de unidades para asegurarte de que la biblioteca funcione correctamente:

      nox

    4. Opcional: También puedes ejecutar las pruebas de unidades con Docker. Primero, asegúrate de tener Docker instalado. Luego, desde el directorio google-ads-python, ejecuta los siguientes comandos:

      docker build -t google-ads-python:test .
docker run -it google-ads-python:test nox