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 version ultérieure.
Prérequis
Avant de continuer, vous aurez besoin d'un jeton de développeur pour l'API Google Ads et 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 "version préliminaire".
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 runtimes 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 les packages gérés par Google qui sont listés comme requis par la bibliothèque cliente Python), nous maintiendrons la compatibilité avec les packages gérés par Google et considérés comme "compatibles" conformément au Règlement sur les modifications incompatibles 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
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 devrez 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 votre authentification. Pour obtenir des instructions détaillées, consultez notre guide d'authentification de la bibliothèque cliente Python. Pour en savoir plus sur le contexte général, consultez notre présentation d'OAuth.
Envoyer une requête d'API
Une fois votre configuration d'authentification définie, vous pouvez effectuer 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, exécutez la commande suivante dans le répertoire racine de la bibliothèque cliente googleads-python installée en local :
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
Ressources supplémentaires
Une fois que vous êtes en mesure d'envoyer une requête d'API, passez aux utilisations suivantes de la bibliothèque cliente :