Prácticas recomendadas para bibliotecas de cliente

A continuación, se indican las prácticas recomendadas para conseguir un rendimiento óptimo y la mejor experiencia posible al usar las bibliotecas de cliente de Cloud y las bibliotecas de cliente de las APIs de Google.

Reutilizar objetos y sesiones de clientes

Cuando hagas solicitudes con la misma biblioteca, deberías reutilizar el mismo objeto de 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 realizada por una instancia de un cliente de sesión realiza la autenticación, la autorización y la generación de tokens de acceso. Este proceso puede tardar varios segundos, ya que se realiza a través de la red. En el caso de las llamadas adicionales en la misma instancia de cliente, el cliente de sesión reutiliza el mismo token de acceso mientras sea válido (normalmente, una hora). Una vez que caduca, el cliente de sesión actualiza el token de acceso automáticamente. Para obtener un rendimiento óptimo, debe reutilizar la misma instancia de cliente de sesión en todas las solicitudes que realice su 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 de cliente tienen límites de velocidad asociados. Como cada instancia del cliente tiene su propia caché de credenciales, si se crean demasiadas en un periodo breve, se puede incurrir en una limitación de la frecuencia, lo que provocará que las solicitudes de la biblioteca no se autentiquen.

Fijar dependencias para producción

Al instalar las bibliotecas desde un gestor de paquetes como npm o pip, es importante fijar las versiones mediante su sistema de control de versiones integrado para usarlas en producción. De esta forma, las compilaciones siempre usarán las mismas versiones de estas bibliotecas. Esto es especialmente importante si decides usar clientes beta, ya que la superficie de sus APIs puede cambiar. En la documentación del paquete de la biblioteca correspondiente se indica lo siguiente:

Mantente al día

A medida que cambian las funciones y las APIs de As Google Cloud, también lo hacen las bibliotecas de cliente. Las bibliotecas cliente cambian a menudo y muchas de ellas reciben actualizaciones y lanzamientos diarios. Para disfrutar de la mejor experiencia de asistencia posible, debes mantenerte al día de las novedades. Muchas de las bibliotecas admiten el control de versiones semántico para que sea fácil determinar cuánto trabajo supondrá una actualización. Si el rendimiento es inferior al habitual (o tienes algún problema) y usas una versión anterior de una biblioteca de cliente, te recomendamos que la actualices para aprovechar todas las mejoras de las versiones más recientes.