Di seguito sono riportate le best practice per aiutarti a ottenere prestazioni ottimali e la migliore esperienza possibile quando utilizzi sia le librerie client di Cloud sia le librerie client delle API di Google.
Riutilizza oggetti client e sessioni
Quando effettui richieste con la stessa libreria, devi riutilizzare lo stesso oggetto client per molte richieste, se possibile, invece di 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 di token di accesso. Questa elaborazione può richiedere diversi secondi mentre avviene sulla rete. Per chiamate aggiuntive sulla stessa istanza client, il client di sessione riutilizza lo stesso token di accesso finché è valido (in genere un'ora). Dopo la scadenza, il client di sessione aggiorna automaticamente il token di accesso. Per prestazioni ottimali, devi riutilizzare la stessa istanza client della sessione per tutte le richieste effettuate dall'applicazione e consentire al client di aggiornare il token di accesso in base alle esigenze per tutte le richieste che devono essere eseguite con lo stesso insieme di credenziali.
Inoltre, ad alcune strategie di autenticazione utilizzate dalle librerie client sono associati dei limiti di frequenza. Poiché ogni istanza del client ha la propria cache delle credenziali, crearne troppe in un breve periodo di tempo potrebbe comportare una limitazione di frequenza, causando la mancata autenticazione delle richieste di libreria.
Blocca 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 in modo coerente le stesse versioni di queste librerie. Ciò è particolarmente importante se scegli di utilizzare client beta che possono cambiare la loro piattaforma API. La documentazione relativa alla libreria pertinente ne indica questo aspetto nella documentazione relativa al pacchetto libreria.
Non perderti gli aggiornamenti
Man mano che le funzionalità e le API di Google Cloud cambiano, cambiano anche le librerie client. Le librerie client cambiano spesso e molte di loro ricevono aggiornamenti e release giornalieri. Per la migliore esperienza di assistenza possibile, devi essere sempre aggiornato sulle release. Molte delle librerie supportano il controllo delle versioni semantico per semplificare la determinazione del lavoro richiesto per un upgrade. Se le prestazioni (o si verifica un problema) sono ridotte e utilizzi una versione precedente di una libreria client, valuta la possibilità di eseguire l'upgrade della libreria per sfruttare tutti i miglioramenti delle versioni più recenti.