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
une 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 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 "fonctionnalité" ou "préversion".
L'équipe 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 compatibles avec 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 suivant une date de fin de vie peuvent entraîner une rupture de 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 assurée avec les packages gérés par Google et considérés comme "compatibles" conformément à la politique de Google concernant les modifications destructives 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. La méthode la plus simple (et recommandée) pour installer la bibliothèque dans votre application consiste à 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 configuré votre authentification, vous pouvez envoyer une requête API. Consultez l'exemple de récupération de campagnes pour tester rapidement que la bibliothèque est correctement configurée pour envoyer des requêtes API.
Pour exécuter l'exemple get_campaigns.py, clonez d'abord le
google-ads-python dépôt. 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 pouvez envoyer une requête API, passez aux utilisations suivantes de la bibliothèque cliente :