La bibliothèque cliente Python est hébergée sur GitHub, et le package est disponible sur PyPI.
Conditions requises
La bibliothèque nécessite Python 3.9 ou une version ultérieure.
Prérequis
Avant de poursuivre ce guide, vous aurez besoin d'un jeton de développeur pour l' API Google Ads et de l'identifiant client à 10 chiffres de votre compte Google Ads.
Compatibilité avec l'environnement d'exécution et les 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".
Nous nous efforçons 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. Nous ne pouvons pas garantir la compatibilité avec les environnements d'exécution en fin de vie, car nous pouvons publier une version de la bibliothèque qui n'est pas compatible avec eux à tout moment après leur date de fin de vie.
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), nous maintiendrons la compatibilité avec les packages qui sont gérés par Google et considérés comme "compatibles" conformément au règlement de Google sur 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
Notre guide d'installation présente 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
Une fois la bibliothèque installée, vous devez la configurer. Il existe plusieurs façons de configurer la bibliothèque, qui sont décrites dans notre guide de configuration.
Authentification
Une fois que vous avez choisi une approche de configuration, vous pouvez configurer l'authentification. Pour obtenir des instructions détaillées, consultez notre guide d'authentification de la bibliothèque cliente Python, et pour obtenir des informations générales, consultez notre présentation d'OAuth.
Envoyer une requête API
Une fois que vous avez configuré l'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, dans le répertoire racine de votre bibliothèque cliente googleads-python installée localement, exécutez la commande suivante :
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_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 :