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 d'obsolescence lors de l'importation dans google-ads v32.0.0 et versions ultérieures, nous vous recommandons d'utiliser Python 3.11 ou une version ultérieure.
Prérequis
Avant de poursuivre, 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 est 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 "feature" ou "prerelease".
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 Versions non compatibles de python.org. La compatibilité avec les environnements d'exécution 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 rompre la compatibilité.
Pour les dépendances (en particulier, tous les packages gérés par Google qui sont répertorié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 aux Règles de modification destructive des logiciels Open Source de Google.
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 les différentes 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 en savoir plus, consultez la présentation d'OAuth.
Envoyer une requête API
Une fois que vous avez défini votre configuration d'authentification, vous pouvez envoyer une requête API. Consultez l'exemple get campaigns pour tester rapidement si la bibliothèque est correctement configurée pour envoyer des requêtes API.
Pour exécuter l'exemple get_campaigns.py, commencez par cloner 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 :