用戶端程式庫最佳做法

下列最佳做法可協助您在使用 Cloud 用戶端程式庫和 Google API 用戶端程式庫時，獲得最佳效能和體驗。

重複使用用戶端物件和工作階段

使用相同程式庫發出要求時，請盡可能重複使用同一個用戶端物件，而不是為每個要求建立新的物件。來自相同執行個體的要求會共用驗證憑證執行個體。

工作階段用戶端執行個體發出的初始要求會執行驗證、授權和存取權杖產生作業。由於這項程序是透過網路進行，因此可能需要幾秒鐘的時間。 在同一個用戶端執行個體上進行其他呼叫時，工作階段用戶端會重複使用相同的存取權杖，只要該權杖有效 (通常為一小時) 即可。過期後，工作階段用戶端會自動重新整理存取權杖。 為獲得最佳效能，您應針對應用程式發出的所有要求重複使用相同的工作階段用戶端例項， 並允許用戶端視需要重新整理存取權杖，以便在同一組憑證下執行所有要求。

此外，用戶端程式庫使用的部分驗證策略會受到頻率限制。由於每個用戶端執行個體都有自己的憑證快取，因此在短時間內建立過多執行個體可能會導致頻率限制，進而導致程式庫要求無法通過驗證。

為正式版固定依附元件

從 npm 或 pip 等套件管理工具安裝程式庫時，請務必使用內建版本控管功能，為正式版用途固定版本。這樣一來，建構作業就會一律使用這些程式庫的相同版本。如果您選擇使用 Beta 版用戶端，API 介面可能會變更，因此請務必留意這點。相關程式庫的說明文件會註明這一點。

掌握最新資訊

隨著 Google Cloud的功能和 API 異動，用戶端程式庫也會隨之更新。用戶端程式庫經常變更，其中許多程式庫每天都會更新及發布。 為獲得最佳支援服務體驗，請務必使用最新版本。許多程式庫都支援語意版本管理，方便您判斷升級需要多少工作量。如果效能降低 (或發生問題)，且您使用的是舊版用戶端程式庫，建議升級至新版，充分運用新版的所有改良功能。