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 volver a usar 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 que realiza 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 en la red. Para 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). Cuando vence, el cliente de sesión actualiza el token de acceso automáticamente. Para obtener un rendimiento óptimo, debes volver a usar la misma instancia del cliente de sesión para todas las solicitudes que haga 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. 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 biblioteca fallen en la autenticación.

Fija las dependencias para producción

Cuando instalas las bibliotecas desde un administrador de paquetes, como npm o pip, es importante fijar las versiones con su control de versiones integrado para uso de producción. Esto garantiza que las compilaciones usen de manera coherente las mismas versiones de estas bibliotecas. Esto es muy importante si optas por usar clientes beta que pueden sufrir cambios en la plataforma de la API. La documentación de la biblioteca correspondiente incluye esto en la documentación del paquete de biblioteca.

Mantente al día

A medida que cambian las capacidades y las APIs de Google Cloud, también cambian las bibliotecas cliente. Las bibliotecas cliente cambian a menudo 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 facilitar la determinación de la cantidad de trabajo que requerirá 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 en las versiones más recientes.