Ya sea que instales la biblioteca desde PyPI o la clones desde GitHub, te recomendamos que realices 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.
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 fácilmente los ejemplos o desarrollar la biblioteca misma. Como referencia, ejecutar uno de los ejemplos de autenticación es un paso obligatorio en la configuración de la biblioteca para su uso.
Asegúrate de que
python3.8
o una versión posterior estén presentes en tu entorno. La forma más sencilla es usarpyenv
:pyenv local 3.8
Clona la biblioteca cliente desde GitHub:
git clone git@github.com:googleads/google-ads-python.git
Ingresa al repositorio y, luego, instálalo:
cd google-ads-python python -m pip install .
Si deseas desarrollar la biblioteca, ejecuta las pruebas de unidades antes y después de realizar cualquier cambio:
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
Instala las dependencias específicas de la prueba de la biblioteca:
python -m pip install .[tests]
Ejecuta las pruebas de unidades para asegurarte de que la biblioteca funcione correctamente:
nox
Opcional: Las pruebas de unidades también se pueden ejecutar con Docker. 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