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.