Prácticas recomendadas para bibliotecas cliente

Las siguientes son las prácticas recomendadas para ayudarlo a obtener un rendimiento óptimo y la mejor experiencia posible al usar las Bibliotecas de cliente de Cloud y las Bibliotecas de cliente de la API de Google.

Reutilice sesiones y objetos de clientes

Cuando realices solicitudes con la misma biblioteca, debes reutilizar el mismo objeto cliente para muchas solicitudes cuando 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 realizada por una instancia de un cliente de sesión realiza la autenticación, autorización y generación de tokens de acceso. Este procesamiento puede tardar varios segundos, ya que se realiza en la red. Para las llamadas adicionales en la misma instancia de 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, deberías reutilizar la misma instancia de cliente de sesión para todas las solicitudes de tu aplicación. y permitir que el cliente actualice el token de acceso según sea necesario para todas las solicitudes que necesiten 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 con ellos. Dado que cada instancia del cliente tiene su propia caché de credenciales, crear demasiadas en un período breve puede generar un límite de frecuencia, lo que provoca que las solicitudes de la biblioteca fallen la autenticación.

Fija las dependencias para producción

Cuando instales las bibliotecas desde un administrador de paquetes, como npm o pip, es importante a fin de fijar las versiones con el control de versiones integrado para el uso en producción. Esto garantiza de forma coherente usarán las mismas versiones de estas bibliotecas. Esto es especialmente importante si decides usar clientes beta que pueden cambiar su plataforma de API. En la documentación de la biblioteca correspondiente, se 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 a menudo y muchas de ellas experimentan actualizaciones y lanzamientos diarios. Mantente al día para obtener la mejor experiencia de asistencia posible con los lanzamientos. Muchas de las bibliotecas admiten el control de versiones semántico para que sea te resultará más fácil determinar cuánto trabajo llevará realizar una actualización. Si experimentas una rendimiento (o algún problema) y estás usando una versión anterior de una biblioteca cliente, considera actualizarla para aprovechar todas las mejoras de las versiones más recientes.