Que vous installiez la bibliothèque à partir de PyPI ou la clonez à partir de GitHub, nous vous recommandons de suivre les étapes ci-dessous à l'aide d'un environnement virtuel actif. Pour en savoir plus sur la création et l'activation d'un environnement virtuel, consultez la documentation relative à l'environnement virtuel.
Installer le module depuis PyPI
La bibliothèque est distribuée sur PyPI et peut être installée à l'aide de pip à l'aide de 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é à partir de GitHub sur votre ordinateur local. Il est utile de cloner le code source pour pouvoir facilement exécuter les exemples ou développer la bibliothèque elle-même. Pour référence, l'exécution de l'un des exemples d'authentification est une étape obligatoire dans la configuration de la bibliothèque à utiliser.
Assurez-vous que
python3.8
ou une version ultérieure est présent dans votre environnement. Le moyen le plus simple est d'utiliserpyenv
:pyenv local 3.8
Clonez la bibliothèque cliente à partir de GitHub:
git clone git@github.com:googleads/google-ads-python.git
Saisissez le 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 toute modification:
Assurez-vous de disposer de toutes les versions compatibles du langage Python disponibles dans votre environnement. Avec
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