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 sur l'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-adsInstaller la bibliothèque depuis GitHub
Vous pouvez cloner le code source de la bibliothèque depuis GitHub sur votre ordinateur local. Il est utile de cloner le code source afin d'exécuter facilement les exemples ou de développer la bibliothèque elle-même. Pour information, exécuter l'un des exemples d'authentification est une étape obligatoire pour configurer la bibliothèque à utiliser.
Assurez-vous que
python3.8ou une version ultérieure est présente dans votre environnement. Le moyen le plus simple consiste à utiliserpyenv:pyenv local 3.8Clonez la bibliothèque cliente depuis GitHub:
git clone git@github.com:googleads/google-ads-python.gitAccédez au dépôt et installez-le:
cd google-ads-python python -m pip install .Si vous avez l'intention 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. En utilisant
pyenv::pyenv local 3.8 3.9 3.10 3.11 3.12Installez 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:
noxFacultatif: les tests unitaires peuvent également être exécutés à l'aide de Docker. Vous devez d'abord avoir installé 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