Praktik terbaik library klien

Berikut adalah praktik terbaik untuk membantu Anda mendapatkan performa yang 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 akan melakukan autentikasi, otorisasi, dan pembuatan token akses. Pemrosesan ini dapat memerlukan waktu beberapa detik, karena terjadi melalui jaringan. Untuk panggilan tambahan pada instance klien yang sama, klien sesi menggunakan kembali token akses yang sama selama valid (biasanya satu jam). Setelah masa berlakunya habis, klien sesi akan otomatis memperbarui token akses. Untuk performa yang optimal, Anda harus menggunakan kembali instance klien sesi yang sama untuk semua permintaan yang dibuat oleh aplikasi Anda, dan mengizinkan klien memuat ulang 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 kapasitas yang terkait dengan strategi tersebut. Karena setiap instance klien memiliki cache kredensialnya sendiri, pembuatan terlalu banyak dalam waktu singkat dapat menyebabkan pembatasan kapasitas yang menyebabkan permintaan library gagal dalam autentikasi.

Sematkan dependensi untuk produksi

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

Selalu dapatkan info terbaru

Saat kemampuan dan API Google Cloud berubah, library klien juga ikut berubah. Library klien sering berubah dan banyak dari mereka melihat update dan rilis harian. Untuk mendapatkan pengalaman dukungan sebaik mungkin, Anda harus terus mendapatkan info terbaru tentang rilis. Banyak library mendukung pembuatan versi semantik untuk memudahkan menentukan seberapa besar pekerjaan yang akan dilakukan pada upgrade. Jika Anda mengalami penurunan performa (atau masalah) dan menggunakan library klien versi lama, sebaiknya upgrade library tersebut untuk memanfaatkan semua peningkatan dalam versi yang lebih baru.