Il s'agit de la bibliothèque client Google API Python pour les API basées sur la découverte de Google. Pour commencer, veuillez consulter le dossier docs.
Cette bibliothèque est considérée comme complète et est en mode maintenance. Cela signifie que nous corrigerons les bogues critiques et les problèmes de sécurité, mais n'ajouterons aucune nouvelle fonctionnalité.
Cette bibliothèque est officiellement prise en charge par Google. Cependant, les responsables de ce référentiel recommandent d'utiliser les bibliothèques clientes Cloud pour Python, lorsque cela est possible, pour le développement de nouveaux codes. Pour plus d’informations, veuillez consulter les bibliothèques client expliquées.
La version 2.0 de google-api-python-client
inclut une amélioration substantielle de la fiabilité par rapport à la version 1.x, car les documents de découverte sont désormais mis en cache dans la bibliothèque plutôt que récupérés dynamiquement. Il est fortement recommandé de passer de la v1.x à la v2.x.
Seul Python 3.7 et versions ultérieures sont pris en charge. Si vous ne parvenez pas à mettre à niveau Python, continuez à utiliser la version 1.x car nous continuerons à prendre en charge Python 2.7+ dans la v1.
Les documents de découverte ne seront plus récupérés dynamiquement lorsque vous appellerez discovery.build()
. Les documents de découverte seront plutôt récupérés directement depuis la bibliothèque cliente. De nouvelles versions de cette bibliothèque sont publiées chaque semaine. Grâce à la mise en cache des documents de découverte, la taille de ce package est d'au moins 50 Mo supérieure à celle de la version précédente.
Veuillez consulter le Guide de migration pour plus d'informations.
Consultez le dossier docs pour des instructions plus détaillées et une documentation supplémentaire.
Les responsables de ce référentiel recommandent d'utiliser les bibliothèques clientes Cloud pour Python, lorsque cela est possible, pour le développement de nouveaux codes pour les raisons suivantes :
Avec les bibliothèques clientes Cloud pour Python :
google-api-python-client
est une bibliothèque client unique pour toutes les API. Par conséquent, la taille totale du package pour google-api-python-client
dépasse 50 Mo.Pour plus d’informations, veuillez consulter les bibliothèques client expliquées.
Bien que le passage aux bibliothèques clientes cloud pour Python présente de nombreux avantages, les responsables souhaitent souligner que google-api-python-client
continuera à être pris en charge.
Pour l'API Google Ads, nous vous recommandons d'utiliser la bibliothèque cliente de l'API Google Ads pour Python.
Pour l'API Google Firebase Admin, nous vous recommandons d'utiliser le SDK Python Firebase Admin.
Installez cette bibliothèque dans un virtualenv en utilisant pip. virtualenv est un outil pour créer des environnements Python isolés. Le problème fondamental qu'il résout est celui des dépendances et des versions, et indirectement des autorisations.
Avec virtualenv, il est possible d'installer cette bibliothèque sans avoir besoin des autorisations d'installation du système et sans entrer en conflit avec les dépendances du système installées.
pip3 install virtualenv
virtualenv < your-env >
source < your-env > /bin/activate
< your-env > /bin/pip install google-api-python-client
pip install virtualenv
virtualenv < your-env >
< your-env > Scriptsactivate
< your-env > Scriptspip.exe install google-api-python-client
Python 3.7, 3.8, 3.9, 3.10, 3.11 et 3.12 sont entièrement pris en charge et testés. Cette bibliothèque peut fonctionner sur les versions ultérieures de 3, mais nous n'effectuons actuellement pas de tests sur ces versions.
Python < 3.7
Les bibliothèques suivantes seront installées lorsque vous installerez la bibliothèque client :
Pour le développement, vous aurez également besoin des bibliothèques suivantes :
Veuillez consulter notre Guide des contributions. En particulier, nous aimons les pull request - mais assurez-vous de signer le contrat de licence du contributeur.