請按照這些外掛程式設計指南,改善使用者的整體體驗。
一般最佳做法
建議您在開發所有外掛程式時,採用下列最佳做法。
開始前確認外掛程式的擁有權
外掛程式是由 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 放入專屬指令碼檔案中,這樣會比較容易管理。
在不同授權模式下徹底測試
測試外掛程式時,請務必嘗試使用含有不同檔案和不同授權狀態的設定。