Instalación

Ya sea que instales la biblioteca desde PyPI o la clones desde GitHub, te recomendamos que realices los pasos que se indican a continuación 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.

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

Instala la biblioteca desde GitHub

El código fuente de la biblioteca se puede clonar desde GitHub en tu máquina local. Es útil clonar el código fuente para ejecutar los ejemplos con facilidad o desarrollar la biblioteca en sí. A modo de 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 python3.8 o una versión posterior esté presente en tu entorno. La forma más sencilla es usar pyenv:

   pyenv local 3.8

2. Clona la biblioteca cliente desde GitHub:

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

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

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

4. Si quieres 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. Usa pyenv:

      pyenv local 3.8 3.9 3.10 3.11 3.12

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

      python -m pip install .[tests]

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

      nox

   4. Opcional: Las pruebas de unidades también se pueden ejecutar con Docker. Primero, debes instalar Docker. Luego, desde el directorio google-ads-python, ejecuta el siguiente comando:

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