La bibliothèque cliente Python est hébergée sur GitHub et le package est disponible sur PyPI.
Conditions requises
La bibliothèque est compatible avec Python 3.9 à 3.14 (>=3.9, <3.15 ; la compatibilité avec Python 3.14 a été ajoutée dans v28.2.0). Étant donné que Python 3.9 et 3.10 émettent un avertissement de dépréciation lors de l'importation dans google-ads v32.0.0 et versions ultérieures, il est recommandé d'utiliser Python 3.11 ou version ultérieure.
Prérequis
Avant de suivre ce guide, vous devez disposer du numéro client à 10 chiffres de votre compte Google Ads.
Compatibilité de l'environnement d'exécution et des dépendances
La bibliothèque cliente Python reste compatible avec les environnements d'exécution Python de la section Versions compatibles publiée par la Python Software Foundation, à l'exception des versions dont l'état est "fonctionnalité" ou "préversion".
L'équipe de l'API Google Ads s'efforce d'adopter les nouvelles versions de l'environnement d'exécution Python dès qu'elles sont publiées et officiellement prises en charge par la Python Software Foundation.
Les environnements d'exécution Python qui ont atteint leur fin de vie ne sont plus compatibles après la date de fin de vie indiquée dans la section Unsupported Versions (Versions non compatibles) de python.org. La compatibilité avec les runtimes en fin de vie ne peut pas être garantie, car les versions de la bibliothèque publiées après une date de fin de vie peuvent être incompatibles.
Pour les dépendances (en particulier, tous les packages gérés par Google qui sont listés comme requis par la bibliothèque cliente Python), la compatibilité est maintenue avec les packages gérés par Google et considérés comme "compatibles" conformément au Règlement de Google sur les modifications incompatibles des logiciels Open Source.
Pour obtenir la liste complète des environnements d'exécution et des dépendances Python compatibles, consultez la page Dépendances.
Installation
Le guide d'installation décrit toutes les manières d'installer la bibliothèque. Le moyen le plus simple (et recommandé) d'installer la bibliothèque dans votre application est d'utiliser pip :
python -m pip install google-ads
Configuration
Après avoir installé la bibliothèque, vous devez la configurer. Il existe plusieurs façons de configurer la bibliothèque, qui sont décrites dans le guide de configuration.
Authentification
Une fois que vous avez choisi une approche de configuration, configurez votre authentification. Pour obtenir des instructions détaillées, consultez le guide d'authentification de la bibliothèque cliente Python. Pour obtenir des informations générales, consultez la présentation d'OAuth.
Envoyer une requête API
Une fois votre configuration d'authentification définie, vous pouvez envoyer une requête d'API. Consultez l'exemple get campaigns pour tester rapidement si la bibliothèque est correctement configurée pour effectuer des requêtes API.
Pour exécuter l'exemple get_campaigns.py, clonez d'abord le dépôt google-ads-python. Ensuite, à partir du répertoire racine du dépôt cloné, exécutez la commande suivante :
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
Ressources supplémentaires
Une fois que vous êtes en mesure d'effectuer une requête API, passez aux utilisations suivantes de la bibliothèque cliente :