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 de 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 a través de la red. Para llamadas adicionales en la misma instancia de cliente, el cliente de sesión reutiliza el mismo token de acceso durante el tiempo que sea válido (por lo general, una hora). Después de que caduca, el cliente de sesión actualiza el token de acceso automáticamente. Para obtener un rendimiento óptimo, es recomendable que reutilices la misma instancia de cliente de sesión para todas las solicitudes que realice tu aplicación y permitas 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 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 hace que las solicitudes de la biblioteca no se autentiquen.

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 optas por utilizar clientes beta en los que la superficie de la API cambie. 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 APIs y las funciones de Google Cloud, también lo hacen las bibliotecas cliente. Las bibliotecas cliente cambian con frecuencia, y muchas de ellas reciben actualizaciones y lanzamientos diarios. Para obtener la mejor experiencia de asistencia posible, debes mantenerte al tanto de las versiones. 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 un rendimiento degradado (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.