Installation

Que vous installiez la bibliothèque à partir de PyPI ou que vous la cloniez depuis GitHub, suivez 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.

Pour créer et activer rapidement un environnement virtuel :

python3 -m venv env
source env/bin/activate

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

Vérifier l'installation

Vérifiez que le module a été correctement installé :

python -c "import google.ads.googleads"

Installer la bibliothèque depuis GitHub

Le code source de la bibliothèque peut être cloné depuis GitHub sur votre ordinateur local. Le clonage du code source est utile pour exécuter les exemples ou pour développer la bibliothèque elle-même. Pour rappel, l'exécution de l'un des exemples d'authentification est une étape obligatoire pour configurer la bibliothèque.

  1. Assurez-vous qu'une version compatible de Python (Python 3.9 à 3.14 ; Python 3.11 ou version ultérieure recommandée) est présente dans votre environnement. Le moyen le plus simple consiste à utiliser pyenv :

    pyenv install 3.13
pyenv local 3.13

  2. Clonez la bibliothèque cliente depuis GitHub :

    git clone https://github.com/googleads/google-ads-python.git

  3. Accédez au dépôt et installez-le en mode modifiable :

    cd google-ads-python
python -m pip install -e .

  4. Si vous avez l'intention de développer la bibliothèque, exécutez les tests unitaires avant et après avoir apporté des modifications :

    1. Assurez-vous que toutes les versions compatibles du langage Python sont disponibles dans votre environnement à l'aide de pyenv :

      pyenv local 3.9 3.10 3.11 3.12 3.13 3.14

    2. Installez les dépendances de la bibliothèque spécifiques aux tests :

      python -m pip install -e ".[tests]"

    3. Exécutez les tests unitaires pour vous assurer que la bibliothèque fonctionne correctement :

      nox

    4. Facultatif : vous pouvez également exécuter les tests unitaires à l'aide de Docker. Tout d'abord, assurez-vous que Docker est installé. Ensuite, à partir du répertoire google-ads-python, exécutez les commandes suivantes :

      docker build -t google-ads-python:test .
docker run -it google-ads-python:test nox