Installation

Que vous installiez la bibliothèque à partir de PyPI ou que vous la cloniez à partir de 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 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. Cloner le code source est utile pour exécuter 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.

  1. Assurez-vous qu'une version Python compatible (Python 3.9 à 3.14, Python 3.11 ou version ultérieure recommandée) est présente dans votre environnement. La méthode la 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 prévoyez 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 spécifiques aux tests de la bibliothèque :

      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 d'avoir installé Docker. 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