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 melakukan autentikasi, otorisasi, dan pembuatan token akses. Pemrosesan ini dapat memerlukan waktu beberapa detik, karena dilakukan melalui jaringan. Untuk panggilan tambahan pada instance klien yang sama, klien sesi menggunakan kembali token akses yang sama selama token tersebut valid (biasanya satu jam). Setelah masa berlakunya habis, klien sesi akan memuat ulang token akses secara otomatis. Untuk performa yang optimal, Anda harus menggunakan kembali instance klien sesi yang sama untuk semua permintaan yang dibuat oleh aplikasi, dan mengizinkan klien memuat ulang token akses sesuai kebutuhan untuk semua permintaan yang perlu dijalankan dalam kumpulan kredensial yang sama.

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

Menyematkan dependensi untuk produksi

Saat menginstal library dari pengelola paket seperti npm atau pip, Anda harus 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 platform API-nya. Dokumentasi untuk library yang relevan akan mencantumkan hal ini di dokumentasi paket library.

Selalu dapatkan info terbaru

Seiring perubahan kemampuan dan API Google Cloud, library klien juga akan berubah. Library klien sering berubah dengan banyak di antaranya yang melihat update dan rilis harian. Untuk mendapatkan pengalaman dukungan terbaik, Anda harus terus mengikuti rilis terbaru. Banyak library yang mendukung pembuatan versi semantik untuk memudahkan penentuan jumlah pekerjaan yang akan dilakukan upgrade. Jika Anda mengalami penurunan performa (atau masalah) dan menggunakan library klien versi lama, sebaiknya upgrade library tersebut untuk memanfaatkan semua peningkatan di versi yang lebih baru.