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.
Riutilizzare oggetti e sessioni client
Quando effettui richieste con la stessa libreria, devi riutilizzare lo stesso oggetto client per molte 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 sessione esegue l'autenticazione, l'autorizzazione e la generazione di token di accesso. Questa elaborazione può richiedere diversi secondi, poiché avviene sulla rete. Per le chiamate aggiuntive sulla stessa istanza client, il client di sessione riutilizza lo stesso token di accesso per tutto il tempo in cui è valido (in genere un'ora). Alla scadenza, il client di sessione aggiorna automaticamente il token di accesso. Per un rendimento ottimale, 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 esigenze 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 una propria cache di credenziali, un numero eccessivo in un breve periodo di tempo può incorrere in una limitazione di frequenza che causa la mancata autenticazione delle richieste della libreria.
Bloccare le dipendenze per la produzione
È importante installare le librerie da un gestore di pacchetti come npm o pip
per bloccare le versioni mediante il controllo delle versioni integrato per l'uso in produzione. Ciò garantisce
le build utilizzeranno sempre le stesse versioni di queste librerie. In particolare
Importante se scegli di utilizzare client beta la cui superficie API può cambiare. La documentazione della libreria pertinente riporta questo aspetto nella documentazione del pacchetto di 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 queste vengono aggiornate e rilasciate quotidianamente. Per ottenere la migliore esperienza di assistenza possibile, è necessario essere sempre aggiornati con le uscite. Molte delle librerie supportano il versionamento semantico per semplificare la determinazione del lavoro necessario per un upgrade. Se le prestazioni sono ridotte rendimento (o un problema) e stai utilizzando una versione precedente di una libreria client, Valuta la possibilità di eseguire l'upgrade per usufruire di tutti i miglioramenti apportati nelle versioni più recenti.