Bonnes pratiques concernant les bibliothèques clientes
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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.
Tenez-vous 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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eReuse client objects and sessions to improve performance by sharing authentication credentials and reusing access tokens, thus avoiding the overhead of repeated authentication processes.\u003c/p\u003e\n"],["\u003cp\u003ePin dependencies in production environments when installing libraries using package managers like \u003ccode\u003enpm\u003c/code\u003e or \u003ccode\u003epip\u003c/code\u003e to ensure consistent builds and avoid unexpected changes, particularly with beta clients.\u003c/p\u003e\n"],["\u003cp\u003eStay updated with client library releases to benefit from the latest performance improvements and to receive optimal support, as these libraries are frequently updated alongside Google Cloud's capabilities.\u003c/p\u003e\n"]]],[],null,["# Client libraries best practices\n\nThe following are best practices to help you get optimum performance and the best experience\npossible when using both the *Cloud Client Libraries* and the *Google API Client Libraries*.\n\nReuse client objects and sessions\n---------------------------------\n\nWhen making requests with the same library, you should reuse the same client object for many requests when possible, instead of creating a new one for every request. Requests from the same instance will share authentication credential instances.\n\nThe initial request made by an instance of a session client\nperforms authentication, authorization, and access token generation.\nThis processing can take multiple seconds, as it happens over the network.\nFor additional calls on the same client instance, the session client reuses the same access token\nfor as long as it is valid (typically one hour). After it expires, the session client refreshes the access token automatically,\nFor optimal performance, you should reuse the same session client instance for all requests made by your application,\nand allow the client to refresh the access token as needed for all requests needing to run under the same set of credentials.\n\nIn addition, some authentication strategies used by the client libraries have rate limits\nassociated with them. Since each instance of the client has its own credential cache, creating\ntoo many in a small period of time may incur rate limiting causing library requests to fail authentication.\n\nPin dependencies for production\n-------------------------------\n\nWhen installing the libraries from a package manager such as `npm` or `pip` it is important\nto pin the versions using their built-in versioning for production usage. This ensures\nbuilds will consistently use the same versions of these libraries. This is especially\nimportant if you opt to use beta clients which can have their API surface change. The documentation for the relevant library notes this on the library package documentation.\n\nStay up to date\n---------------\n\nAs Google Cloud's capabilities and APIs change, so do the client libraries.\nClient libraries change often with many of them seeing daily updates and releases.\nIn order to get the best possible support experience possible, you should stay up to date\nwith the releases. Many of the libraries support semantic versioning to make it\neasy to determine how much work an upgrade will be. If you are experiencing a degraded\nperformance (or an issue) and you are using an older version of a client library,\nconsider upgrading it to take advantage of all improvements in newer versions."]]
