En esta página, se describen algunas prácticas recomendadas para usar las bibliotecas cliente de Cloud y las bibliotecas cliente de las APIs de Google, que te ayudan a optimizar el rendimiento y mantener compilaciones de producción confiables.
Reutilice sesiones y objetos de clientes
Cuando realices solicitudes con la misma biblioteca, debes reutilizar el mismo objeto cliente para muchas solicitudes siempre que sea posible, en lugar de crear uno nuevo para cada solicitud. Las solicitudes de la misma instancia compartirán instancias de credenciales de autenticación.
La solicitud inicial que realiza una instancia de un cliente de sesión lleva a cabo la autenticación, la autorización y la generación de tokens de acceso. Este procesamiento puede tardar varios segundos, ya que se realiza a través de la red. Para las llamadas adicionales en la misma instancia del cliente, el cliente de sesión reutiliza el mismo token de acceso mientras sea válido (por lo general, una hora). Después de que vence, el cliente de sesión actualiza el token de acceso automáticamente. Para obtener un rendimiento óptimo, debes reutilizar la misma instancia del cliente de sesión para todas las solicitudes que realice tu aplicación y permitir que el cliente actualice el token de acceso según sea necesario para todas las solicitudes que deban ejecutarse con el mismo conjunto de credenciales.
Además, algunas estrategias de autenticación que usan las bibliotecas cliente tienen límites de frecuencia asociados. Dado que cada instancia del cliente tiene su propia caché de credenciales, crear demasiadas en un período corto puede generar límite de frecuencia que provoquen que las solicitudes de la biblioteca no superen la autenticación.
Fija las dependencias para producción
Cuando instales las bibliotecas desde un administrador de paquetes como npm o pip, es importante fijar las versiones con su control de versiones integrado para el uso en producción. Esto garantiza que las compilaciones siempre usen las mismas versiones de estas bibliotecas. Esto es especialmente importante si optas por usar clientes beta, cuya superficie de API puede cambiar. La documentación de la biblioteca pertinente indica esto en la documentación del paquete de la biblioteca.
Mantente al día
A medida que cambian las capacidades y las APIs de Google Cloud, también lo hacen las bibliotecas cliente. Las bibliotecas cliente cambian con frecuencia, y muchas de ellas reciben actualizaciones y versiones diarias. Para obtener la mejor experiencia de asistencia posible, debes mantenerte al día con las versiones. Muchas de las bibliotecas admiten el control de versiones semánticas para que sea fácil determinar cuánto trabajo implicará una actualización. Si experimentas un rendimiento reducido (o un problema) y usas una versión anterior de una biblioteca cliente, considera actualizarla para aprovechar todas las mejoras de las versiones más recientes.