本頁說明使用 Cloud 用戶端程式庫和 Google API 用戶端程式庫時的一些最佳做法,有助於提升效能及維護可靠的正式版建構作業。
重複使用用戶端物件和工作階段
使用相同程式庫提出要求時,請盡可能重複使用同一個用戶端物件,而不是為每個要求建立新物件。來自相同執行個體的請求會共用驗證憑證執行個體。
工作階段用戶端執行個體發出的初始要求會執行驗證、授權和存取權杖產生作業。由於處理作業是透過網路進行,因此可能需要數秒時間。 在同一個用戶端例項上進行其他呼叫時,只要存取權杖有效 (通常為一小時),工作階段用戶端就會重複使用該權杖。過期後,工作階段用戶端會自動重新整理存取權杖。 為獲得最佳效能,您應針對應用程式發出的所有要求重複使用相同的工作階段用戶端執行個體, 並允許用戶端視需要重新整理存取權杖,以便在同一組憑證下執行所有要求。
此外,用戶端程式庫使用的部分驗證策略會受到速率限制。由於每個用戶端例項都有自己的憑證快取,因此在短時間內建立過多例項可能會導致速率限制,進而造成程式庫要求無法通過驗證。
固定正式版依附元件
從 npm 或 pip 等套件管理工具安裝程式庫時,請務必使用內建版本管理功能,為正式版用途固定版本。這樣可確保建構作業一律使用這些程式庫的相同版本。如果您選擇使用 Beta 版用戶端,這點就格外重要,因為 Beta 版用戶端的 API 介面可能會變更。相關程式庫的說明文件會在程式庫套件說明文件中註明這一點。
掌握最新資訊
隨著 Google Cloud的功能和 API 異動,用戶端程式庫也會隨之更新。用戶端程式庫經常變更,其中許多程式庫每天都會更新及發布。 為獲得最佳支援服務體驗,請務必使用最新版本。許多程式庫都支援語意版本管理,方便您判斷升級需要多少工作量。如果效能降低 (或發生問題),且您使用的是舊版用戶端程式庫,建議升級至新版,以充分運用所有改良功能。