Instalación

Ya sea que instales la biblioteca desde PyPI o la clones desde GitHub, te recomendamos que sigas 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 sobre el entorno virtual.

Instala el módulo desde PyPI

La biblioteca se distribuye en PyPI y se puede instalar mediante 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 por sí misma. A modo de referencia, ejecutar uno de los ejemplos de autenticación es un paso obligatorio en la configuración de la biblioteca para su uso.

1. Asegúrate de que python3.8 o una versión posterior estén presentes en tu entorno. La forma más sencilla es usar pyenv:

   pyenv local 3.8
   

2. Clona la biblioteca cliente desde GitHub:

   git clone [e-mail]:googleads/google-ads-python.git
   

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

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

4. Si deseas 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 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. Las pruebas de unidades también se pueden ejecutar con Docker (opcional). Primero, debes tener Docker instalado. Luego, desde el directorio google-ads-python, ejecuta lo siguiente:

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