Que vous installiez la bibliothèque à partir de PyPI ou la cloniez à partir de GitHub, nous vous recommandons d'effectuer les étapes ci-dessous dans un environnement virtuel actif. Pour en savoir plus sur la création et l'activation d'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é à partir de 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 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ésente 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
Accé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. 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 vérifier 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 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