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-adsInstaller 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.8ou version ultérieure est présent 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 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.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. 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