Que vous installiez la bibliothèque à partir de PyPI ou que vous la cloniez à partir de GitHub, nous nous vous recommandons d'effectuer les étapes ci-dessous à l'aide d'une console environnement. Pour en savoir plus sur la création et l'activation d'une VM consultez la documentation sur les environnements virtuels.
Installer le module depuis PyPI
La bibliothèque est distribuée sur PyPI et peut être installé à l'aide de pip avec la 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. À titre indicatif, exécuter l'un des exemples d'authentification est une étape requise dans la configuration de la bibliothèque pour les utiliser.
Assurez-vous que
python3.8ou une version ultérieure est présent dans votre environnement. Le moyen le plus simple est d'utiliserpyenv:pyenv local 3.8Clonez la bibliothèque cliente à partir de GitHub:
git clone git@github.com:googleads/google-ads-python.gitSaisissez 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 apporter des modifications:
Vérifiez que vous disposez de toutes les versions compatibles du langage Python dans votre environnement. Avec
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 Docker est installé. Puis, à partir de le 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