Instalación

Ya sea que instales la biblioteca desde PyPI o la clones desde GitHub, se recomienda que realices los siguientes pasos con una cuenta en un entorno de nube. Para obtener información sobre cómo crear y activar un servicio consulta la documentación de Entorno virtual.

Instala el módulo desde PyPI

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

python -m pip install google-ads

Instala la biblioteca desde GitHub

El código fuente para la biblioteca se puede clonar desde GitHub en tu máquina local. Es útil clonar el código fuente para poder ejecutar los ejemplos o desarrollar la propia 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 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 al 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. realizar cambios:

   1. Asegúrate de tener disponibles todas las versiones compatibles del lenguaje Python 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. En primer lugar, debes tener Docker instalado Luego, desde google-ads-python, ejecuta lo siguiente:

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