Installation
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Que vous installiez la bibliothèque à partir de PyPI ou que vous la cloniez à partir de GitHub, nous vous recommandons de suivre les étapes ci-dessous à l'aide d'un environnement virtuel actif. Pour savoir comment créer et activer un environnement virtuel, consultez la documentation Environnement virtuel.
Installer le module à partir de PyPI
La bibliothèque est distribuée sur PyPI et peut être installée à l'aide de pip avec la commande suivante :
python -m pip install google-ads
Installer la bibliothèque depuis GitHub
Le code source de la bibliothèque peut être cloné depuis GitHub sur votre ordinateur local. Il est utile de cloner le code source pour exécuter facilement les exemples ou développer la bibliothèque elle-même. Pour information, l'exécution de l'un des exemples d'authentification est une étape obligatoire pour configurer la bibliothèque.
Assurez-vous que python3.8 ou version ultérieure est présent dans votre environnement.
Le moyen le plus simple consiste à utiliser pyenv :
pyenv local 3.8
Clonez la bibliothèque cliente depuis GitHub :
git clone git@github.com:googleads/google-ads-python.git
Accédez au dépôt et installez-le :
cd google-ads-python
python -m pip install .
Si vous prévoyez de développer la bibliothèque, exécutez les tests unitaires avant et après avoir apporté des modifications :
Assurez-vous que toutes les versions compatibles du langage Python sont disponibles dans votre environnement. Utiliser pyenv :
pyenv local 3.8 3.9 3.10 3.11 3.12
Installez les dépendances spécifiques aux tests de la bibliothèque :
python -m pip install .[tests]
Exécutez les tests unitaires pour vous assurer que la bibliothèque fonctionne correctement :
nox
Facultatif : les tests unitaires peuvent également être exécutés à l'aide de Docker. Tout d'abord, vous devez installer Docker. Ensuite, à partir du répertoire google-ads-python, exécutez la commande suivante :
docker build -t google-ads-python:test .
docker run -it google-ads-python:test nox
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/27 (UTC).
[null,null,["Dernière mise à jour le 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"]]
