google api python client

Cliente API de Google

Esta es la biblioteca cliente API Python de Google para las API basadas en descubrimiento de Google. Para comenzar, consulte la carpeta de documentos.

Esta biblioteca se considera completa y se encuentra en modo de mantenimiento. Esto significa que abordaremos errores críticos y problemas de seguridad, pero no agregaremos ninguna característica nueva.

Esta biblioteca cuenta con el respaldo oficial de Google. Sin embargo, los mantenedores de este repositorio recomiendan utilizar las bibliotecas cliente de la nube para Python, siempre que sea posible, para el desarrollo de código nuevo. Para obtener más información, visite Explicación de las bibliotecas de clientes.

Lanzamiento de la versión 2.0

La versión 2.0 de google-api-python-client incluye una mejora sustancial en la confiabilidad, en comparación con la versión 1.x, ya que los documentos de descubrimiento ahora se almacenan en caché en la biblioteca en lugar de recuperarse dinámicamente. Se recomienda encarecidamente actualizar de v1.x a v2.x.

Solo se admite Python 3.7 y versiones posteriores. Si no puede actualizar Python, continúe usando la versión 1.x ya que continuaremos admitiendo Python 2.7+ en v1.

Los documentos de descubrimiento ya no se recuperarán dinámicamente cuando llame discovery.build() . En cambio, los documentos de descubrimiento se recuperarán directamente de la biblioteca del cliente. Semanalmente se publican nuevas versiones de esta biblioteca. Como resultado del almacenamiento en caché de los documentos de descubrimiento, el tamaño de este paquete es al menos 50 MB mayor en comparación con la versión anterior.

Consulte la Guía de migración para obtener más información.

Documentación

Consulte la carpeta de documentos para obtener instrucciones más detalladas y documentación adicional.

Otras bibliotecas API de Google

Los mantenedores de este repositorio recomiendan usar Cloud Client Libraries para Python, siempre que sea posible, para el desarrollo de código nuevo debido a los siguientes motivos:

Con bibliotecas cliente en la nube para Python:

• Hay una biblioteca de cliente separada para cada API, por lo que puede elegir qué bibliotecas de cliente descargar. Mientras que google-api-python-client es una biblioteca de cliente única para todas las API. Como resultado, el tamaño total del paquete para google-api-python-client supera los 50 MB.
• Existen controles más estrictos para cambios importantes en las API subyacentes, ya que cada biblioteca cliente se centra en una API específica.
• Hay más funciones en estas bibliotecas de cliente en la nube, ya que cada biblioteca se centra en una API específica y, en algunos casos, las bibliotecas son propiedad de un equipo especializado en esa API.
• Los desarrolladores se beneficiarán de Intellisense.

Para obtener más información, visite Explicación de las bibliotecas de clientes.

Aunque hay muchos beneficios al pasar a las bibliotecas cliente en la nube para Python, los encargados del mantenimiento quieren enfatizar que google-api-python-client seguirá siendo compatible.

Para la API de Google Ads, recomendamos utilizar la biblioteca cliente de la API de Google Ads para Python.

Para la API de administración de Google Firebase, recomendamos utilizar el SDK de Python de Firebase Admin.

Instalación

Instale esta biblioteca en un virtualenv usando pip. virtualenv es una herramienta para crear entornos Python aislados. El problema básico que aborda es el de dependencias y versiones, e indirectamente de permisos.

Con virtualenv, es posible instalar esta biblioteca sin necesidad de permisos de instalación del sistema y sin chocar con las dependencias del sistema instaladas.

Mac/Linux

pip3 install virtualenv
virtualenv < your-env >
source < your-env > /bin/activate
< your-env > /bin/pip install google-api-python-client

ventanas

pip install virtualenv
virtualenv < your-env >
< your-env > Scriptsactivate
< your-env > Scriptspip.exe install google-api-python-client

Versiones de Python compatibles

Python 3.7, 3.8, 3.9, 3.10, 3.11 y 3.12 son totalmente compatibles y probados. Esta biblioteca puede funcionar en versiones posteriores de 3, pero actualmente no realizamos pruebas con esas versiones.

Versiones de Python no compatibles

Pitón <3.7

Bibliotecas y dependencias de terceros

Las siguientes bibliotecas se instalarán cuando instale la biblioteca cliente:

• httplib2
• plantilla de orina

Para el desarrollo también necesitarás las siguientes bibliotecas:

• Prueba web
• pyopenssl

Contribuyendo

Consulte nuestra Guía de contribuciones. En particular, nos encantan las solicitudes de extracción, pero asegúrese de firmar el acuerdo de licencia de colaborador.