最佳做法

請按照這些外掛程式設計指南，改善使用者的整體體驗。

一般最佳做法

建議您在開發所有外掛程式時，採用下列最佳做法。

開始前確認外掛程式的擁有權

外掛程式是由 Apps Script 專案定義，這些專案必須由特定帳戶擁有，或放置在共用雲端硬碟中。編寫外掛程式程式碼前，請先決定專案應由哪個帳戶擁有，以及哪個帳戶擔任發布者。另外，請決定哪些帳戶要擔任協作者，並確保這些帳戶有權存取指令碼專案及其相關的 Google Cloud 專案。

注意： 請務必規劃好外掛程式的擁有權。如果外掛程式擁有者離開貴機構，您必須確保擁有權已轉移，否則可能會失去更新及管理外掛程式的權限。因此，建議您建立專屬的機構帳戶，用於擁有及發布貴機構的外掛程式。你也可以使用共用雲端硬碟擔任指令碼專案擁有者，但特定帳戶必須擔任外掛程式發布者。

擴充 Google Workspace 功能，而非複製

外掛程式可為擴充的 Google Workspace 應用程式提供新功能，或自動執行複雜的工作。如果外掛程式只是複製應用程式中已有的功能，或是無法大幅改善工作流程，就可能無法通過外掛程式審查而無法發布。

縮小範圍

明確定義範圍時，請一律選擇最不寬鬆的範圍集合。舉例來說，如果外掛程式只需要讀取權，就不要使用 https://www.googleapis.com/auth/calendar 範圍要求使用者日曆的完整存取權。如需唯讀存取權，請使用 https://www.googleapis.com/auth/calendar.readonly 範圍。

避免過度依賴程式庫

使用 Apps Script 程式庫可能會導致外掛程式執行速度變慢，而非將所有 Apps Script 程式碼包含在單一指令碼專案中。雖然 Apps Script 程式庫可在外掛程式中運作，但如果使用這些程式庫，效能可能會降低。請勿在專案中加入不必要的程式庫，並考慮如何減少外掛程式對這些程式庫的依賴。

上述延遲時間僅適用於用於伺服器端程式庫的 Apps Script 專案。您可以自由使用 jQuery 等用戶端 JavaScript 程式庫，而不會遇到延遲問題。

編輯器外掛程式的最佳做法

下列最佳做法僅適用於編輯器外掛程式。

將介面 HTML 和用戶端 JavaScript 置於各自的指令碼檔案中

您可以在 Apps Script 專案中建立多個指令碼檔案。如要管理複雜的外掛程式，請將定義外掛程式側邊欄和對話方塊的 HTML 和 JavaScript 放入專屬指令碼檔案中，這樣會比較容易管理。

在不同授權模式下徹底測試

測試外掛程式時，請務必嘗試使用含有不同檔案和不同授權狀態的設定。