Praktik terbaik library klien

Berikut adalah praktik terbaik untuk membantu Anda mendapatkan performa optimal dan pengalaman terbaik saat menggunakan Library Klien Cloud dan Library Klien Google API.

Menggunakan kembali objek dan sesi klien

Saat membuat permintaan dengan library yang sama, Anda harus menggunakan kembali objek klien yang sama untuk banyak permintaan jika memungkinkan, bukan membuat objek baru untuk setiap permintaan. Permintaan dari instance yang sama akan berbagi instance kredensial autentikasi.

Permintaan awal yang dibuat oleh instance klien sesi melakukan autentikasi, otorisasi, dan pembuatan token akses. Pemrosesan ini dapat memakan waktu beberapa detik, karena terjadi melalui jaringan. Untuk panggilan tambahan pada instance klien yang sama, klien sesi menggunakan kembali token akses yang sama selama masih valid (biasanya satu jam). Setelah masa berlakunya berakhir, klien sesi akan memperbarui token akses secara otomatis. Untuk performa yang optimal, Anda harus menggunakan kembali instance klien sesi yang sama untuk semua permintaan yang dibuat oleh aplikasi Anda, dan mengizinkan klien untuk memperbarui token akses sesuai kebutuhan untuk semua permintaan yang perlu dijalankan dengan kumpulan kredensial yang sama.

Selain itu, beberapa strategi autentikasi yang digunakan oleh library klien memiliki batas frekuensi yang terkait dengannya. Karena setiap instance klien memiliki cache kredensialnya sendiri, membuat terlalu banyak cache dalam jangka waktu singkat dapat menimbulkan pembatasan kapasitas yang menyebabkan permintaan library gagal diautentikasi.

Menyematkan dependensi untuk produksi

Saat menginstal library dari pengelola paket seperti npm atau pip, penting untuk menyematkan versi menggunakan pembuatan versi bawaan untuk penggunaan produksi. Tindakan ini memastikan build akan secara konsisten menggunakan versi library yang sama. Hal ini sangat penting jika Anda memilih untuk menggunakan klien beta yang dapat mengubah antarmuka API-nya. Dokumentasi untuk library yang relevan mencatat hal ini dalam dokumentasi paket library.

Selalu dapatkan info terbaru

Saat kemampuan dan API As Google Cloudberubah, library klien juga akan berubah. Library klien sering berubah dengan banyak di antaranya menerima update dan rilis harian. Untuk mendapatkan pengalaman dukungan terbaik, Anda harus terus mendapatkan info terbaru tentang rilis. Banyak library mendukung pembuatan versi semantik untuk mempermudah penentuan jumlah pekerjaan yang diperlukan untuk upgrade. Jika Anda mengalami penurunan performa (atau masalah) dan menggunakan library klien versi lama, sebaiknya upgrade library klien untuk memanfaatkan semua peningkatan di versi yang lebih baru.