Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-11 UTC."],[[["\u003cp\u003eReuse client objects and sessions to improve performance by sharing authentication credentials and reusing access tokens, thus avoiding the overhead of repeated authentication processes.\u003c/p\u003e\n"],["\u003cp\u003ePin dependencies in production environments when installing libraries using package managers like \u003ccode\u003enpm\u003c/code\u003e or \u003ccode\u003epip\u003c/code\u003e to ensure consistent builds and avoid unexpected changes, particularly with beta clients.\u003c/p\u003e\n"],["\u003cp\u003eStay updated with client library releases to benefit from the latest performance improvements and to receive optimal support, as these libraries are frequently updated alongside Google Cloud's capabilities.\u003c/p\u003e\n"]]],[],null,["# Client libraries best practices\n\nThe following are best practices to help you get optimum performance and the best experience\npossible when using both the *Cloud Client Libraries* and the *Google API Client Libraries*.\n\nReuse client objects and sessions\n---------------------------------\n\nWhen making requests with the same library, you should reuse the same client object for many requests when possible, instead of creating a new one for every request. Requests from the same instance will share authentication credential instances.\n\nThe initial request made by an instance of a session client\nperforms authentication, authorization, and access token generation.\nThis processing can take multiple seconds, as it happens over the network.\nFor additional calls on the same client instance, the session client reuses the same access token\nfor as long as it is valid (typically one hour). After it expires, the session client refreshes the access token automatically,\nFor optimal performance, you should reuse the same session client instance for all requests made by your application,\nand allow the client to refresh the access token as needed for all requests needing to run under the same set of credentials.\n\nIn addition, some authentication strategies used by the client libraries have rate limits\nassociated with them. Since each instance of the client has its own credential cache, creating\ntoo many in a small period of time may incur rate limiting causing library requests to fail authentication.\n\nPin dependencies for production\n-------------------------------\n\nWhen installing the libraries from a package manager such as `npm` or `pip` it is important\nto pin the versions using their built-in versioning for production usage. This ensures\nbuilds will consistently use the same versions of these libraries. This is especially\nimportant if you opt to use beta clients which can have their API surface change. The documentation for the relevant library notes this on the library package documentation.\n\nStay up to date\n---------------\n\nAs Google Cloud's capabilities and APIs change, so do the client libraries.\nClient libraries change often with many of them seeing daily updates and releases.\nIn order to get the best possible support experience possible, you should stay up to date\nwith the releases. Many of the libraries support semantic versioning to make it\neasy to determine how much work an upgrade will be. If you are experiencing a degraded\nperformance (or an issue) and you are using an older version of a client library,\nconsider upgrading it to take advantage of all improvements in newer versions."]]
