Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Di seguito sono riportate le best practice per ottenere prestazioni ottimali e la migliore esperienza
possibile quando utilizzi sia le librerie client di Cloud sia le librerie client delle API di Google.
Riutilizzare oggetti e sessioni client
Quando effettui richieste con la stessa libreria, dovresti riutilizzare lo stesso oggetto client per più richieste, se possibile, anziché crearne uno nuovo per ogni richiesta. Le richieste della stessa istanza condivideranno le istanze delle credenziali di autenticazione.
La richiesta iniziale effettuata da un'istanza di un client di sessione
esegue l'autenticazione, l'autorizzazione e la generazione del token di accesso.
L'elaborazione può richiedere diversi secondi, poiché avviene tramite la rete.
Per le chiamate aggiuntive sulla stessa istanza client, il client di sessione riutilizza lo stesso token di accesso
per tutto il periodo di validità (in genere un'ora). Una volta scaduto, il client di sessione aggiorna automaticamente il token di accesso.
Per prestazioni ottimali, devi riutilizzare la stessa istanza del client di sessione per tutte le richieste effettuate dalla tua applicazione
e consentire al client di aggiornare il token di accesso in base alle necessità per tutte le richieste che devono essere eseguite con lo stesso insieme di credenziali.
Inoltre, alcune strategie di autenticazione utilizzate dalle librerie client hanno limiti di frequenza
associati. Poiché ogni istanza del client ha la propria cache delle credenziali, la creazione di un numero eccessivo di credenziali in un breve periodo di tempo potrebbe comportare la limitazione di frequenza, causando l'autenticazione non riuscita delle richieste della libreria.
Bloccare le dipendenze per la produzione
Quando installi le librerie da un gestore di pacchetti come npm o pip, è importante
bloccare le versioni utilizzando il controllo delle versioni integrato per l'utilizzo in produzione. In questo modo, le build utilizzeranno sempre le stesse versioni di queste librerie. Ciò è particolarmente
importante se scegli di utilizzare client beta la cui superficie API può cambiare. La documentazione della libreria pertinente lo indica nella documentazione del pacchetto della libreria.
Non perderti gli aggiornamenti
Man mano che le funzionalità e le API di Google Cloudcambiano, cambiano anche le librerie client.
Le librerie client cambiano spesso e molte di loro vengono aggiornate e rilasciate quotidianamente.
Per ottenere la migliore esperienza di assistenza possibile, devi rimanere aggiornato
con le release. Molte librerie supportano il controllo delle versioni semantico per semplificare la determinazione della quantità di lavoro necessaria per un upgrade. Se riscontri un peggioramento
delle prestazioni (o un problema) e utilizzi una versione precedente di una libreria client,
valuta la possibilità di eseguire l'upgrade per sfruttare tutti i miglioramenti delle versioni più recenti.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]
