Voici les bonnes pratiques pour vous aider à obtenir des performances optimales et à profiter de la meilleure expérience possible lorsque vous utilisez à la fois les bibliothèques clientes Cloud et les bibliothèques clientes Google API.
Réutiliser les objets et sessions client
Lorsque vous effectuez des requêtes auprès de la même bibliothèque, vous devez réutiliser le même objet client pour de nombreuses requêtes lorsque cela est possible, au lieu d'en créer un nouveau pour chaque demande. Les demandes provenant de la même instance partageront des instances d'authentification.
Les opérations d'authentification, d'autorisation et de génération du jeton d'accès sont exécutées lors de la requête initiale envoyée par une instance de client de session. Ce traitement peut prendre plusieurs secondes, car il se produit sur le réseau. Pour les appels supplémentaires sur la même instance client, le client de session réutilise le même jeton d'accès tant qu'il est valide (généralement une heure). Une fois expiré, le client de session actualise automatiquement le jeton d'accès. Pour des performances optimales, vous devez réutiliser la même instance de client de session pour toutes les requêtes effectuées par votre application et permettre au client d'actualiser le jeton d'accès si nécessaire pour toutes les requêtes devant être exécutées avec le même ensemble d'identifiants.
De plus, certaines stratégies d'authentification employées par les bibliothèques clientes sont associées à des limites de débit. Étant donné que chaque instance du client possède son propre cache d'identifiants, la création d'un trop grand nombre en peu de temps peut entraîner une limitation du débit entraînant l'échec de l'authentification des requêtes de bibliothèque.
Épingler des dépendances pour la production
Lors de l'installation des bibliothèques à partir d'un gestionnaire de packages tel que npm ou pip, il est important d'épingler les versions à l'aide de la gestion des versions intégrée pour une utilisation en production. Ainsi, les versions utiliseront systématiquement les mêmes versions de ces bibliothèques. Cet élément est particulièrement important si vous choisissez d'utiliser des clients bêta dont la surface de l'API peut changer. La documentation de la bibliothèque concernée l'indique dans la documentation du package de bibliothèque.
Restez informé
Les capacités et les API de Google Cloud évoluent, tout comme les bibliothèques clientes. Les bibliothèques clientes changent souvent et nombre d'entre elles sont sujettes à des mises à jour et à des changements de version quotidiens. Afin de profiter de la meilleure expérience d'assistance possible, vous devez vous tenir informé des nouvelles versions. De nombreuses bibliothèques prennent en charge le contrôle de version sémantique pour faciliter la détermination du volume de travail d'une mise à niveau. En cas de dégradation des performances (ou de problème) et que vous utilisez une ancienne version d'une bibliothèque cliente, envisagez de la mettre à niveau pour profiter de toutes les améliorations qu'offrent les versions plus récentes.