Instalación
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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 los ejemplos con facilidad 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.
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
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 planeas 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 de la siguiente manera:
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 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
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-27 (UTC)
[null,null,["Última actualización: 2025-08-27 (UTC)"],[[["\u003cp\u003eThe Google Ads Python library can be installed from PyPI using pip with the command \u003ccode\u003epython -m pip install google-ads\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTo install from GitHub, clone the repository, navigate into it, and run \u003ccode\u003epython -m pip install .\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEnsure you have Python 3.8 or later installed in your environment, potentially using pyenv.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should run unit tests before and after making changes, utilizing nox or Docker for execution.\u003c/p\u003e\n"],["\u003cp\u003eFor library setup and usage, refer to the Virtual Environment and authentication example documentation.\u003c/p\u003e\n"]]],[],null,["# Installation\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nWhether you're installing the library from PyPI or cloning it from GitHub, we\nrecommended that you conduct the below steps using an active virtual\nenvironment. For information on how to create and activate a virtual\nenvironment, see the [Virtual Environment](//docs.python.org/3/tutorial/venv.html) documentation.\n\nInstall the module from PyPI\n----------------------------\n\nThe library is distributed on [PyPI](//pypi.org/project/google-ads/) and can\nbe installed using [pip](//pip.pypa.io/en/stable/installing) with the\nfollowing command: \n\n python -m pip install google-ads\n\nInstall the library from GitHub\n-------------------------------\n\nThe source code for the library can be cloned from [GitHub](https://github.com/googleads/google-ads-python/)\nonto your local machine. It's useful to clone the source code in order to easily\nexecute the examples or to develop the library itself. For reference, running\none of the authentication examples is a required step in configuring the library\nfor use.\n\n1. Ensure that `python3.8` or later is present in your environment.\n The simplest way is to use [`pyenv`](//github.com/pyenv/pyenv-installer):\n\n pyenv local 3.8\n\n2. Clone the client library from GitHub:\n\n git clone git@github.com:googleads/google-ads-python.git\n\n3. Enter the repository and install it:\n\n cd google-ads-python\n python -m pip install .\n\n4. If you intend to develop the library, run the unit tests before and after\n making any changes:\n\n 1. Ensure you have all supported versions of the Python language available in\n your environment. Using `pyenv`::\n\n pyenv local 3.8 3.9 3.10 3.11 3.12\n\n 2. Install the test-specific dependencies of the library:\n\n python -m pip install .[tests]\n\n 3. Run the unit tests to ensure the library is functioning properly:\n\n nox\n\n 4. Optional: the unit tests can also be run using Docker. First, you must\n have [Docker installed](https://docs.docker.com/get-docker/). Then, from\n the `google-ads-python` directory, run the following:\n\n docker build -t google-ads-python:test .\n docker run -it google-ads-python:test nox"]]
