使用外掛程式擴充 Google 試算表

Google 試算表是雲端式試算表解決方案，提供即時協作功能和強大工具，可用於視覺化、處理及傳達資料。

您可以使用外掛程式擴充試算表，藉此建立自訂工作流程改善項目、建立與第三方系統的連線，以及將試算表資料與其他 Google Workspace 應用程式 (例如 Google 簡報) 整合。

您可以在 Google Workspace Marketplace 中查看其他人建立的 Google 試算表外掛程式。

建議做法

以下列舉幾項可透過 Google 試算表外掛程式擴充功能執行的操作：

試算表外掛程式是使用 Apps Script 建構而成。如要進一步瞭解如何使用 Apps Script 存取及管理 Google 試算表，請參閱「擴充 Google 試算表」一文。

工作表結構

Google 試算表由一或多個試算表組成。每個試算表本質上都是 2D 儲存格格線，可用於儲存文字、數字、連結或其他值。一或多個相鄰儲存格組合稱為範圍。

Apps Script 試算表服務提供多個類別，用於代表試算表中的組織結構 (例如 Sheet 和 Range)。您可以使用這些類別讀取及修改試算表資料和行為。

觸發條件

Apps Script 觸發事件可讓指令碼專案在符合特定條件時 (例如開啟試算表或安裝外掛程式) 執行指定函式。

如要進一步瞭解可與試算表外掛程式搭配使用的觸發事件，以及使用這些觸發事件時的限制，請參閱「外掛程式觸發事件」。

自訂函式

Google 試算表提供多個內建函式，例如 SUM 和 AVERAGE，可從 Google 試算表儲存格中叫用。試算表外掛程式可定義其他自訂函式，用來補充這些內建函式。使用者安裝外掛程式後，外掛程式內含的任何定義自訂函式都會立即可用。外掛程式可以只包含自訂函式定義。您可以透過發布含有定義的加購項目，將自訂函式定義分享給其他人。

建立外掛程式自訂函式

您可以在外掛程式專案中定義的任何函式，做為自訂函式使用。函式導入並安裝外掛程式後，您可以像呼叫任何其他 Google 試算表內建函式一樣呼叫自訂函式：在試算表儲存格中輸入 =，後面接著函式名稱和任何必要參數。如果沒有錯誤，函式傳回的結果會放置在工作表儲存格中，並視需要溢流至相鄰的儲存格。

在外掛程式中建立自訂函式時，請遵循一般自訂函式的規範：

此外，在外掛程式中定義的自訂函式有幾項特別的考量：

  • 命名函式時，請盡量使用不重複的名稱，例如與外掛程式名稱相關的名稱。如果兩個以上已安裝的擴充功能定義了同名的自訂函式，使用者只能使用其中一個函式。
  • 外掛程式應清楚說明提供哪些自訂功能。請務必為自訂函式提供正確的 JSDoc 註解，以便 Apps Script 向使用者顯示autocomplete資訊。此外，建議您在外掛程式本身或外掛程式支援網頁中，提供自訂函式的其他說明文件。
  • 未在 30 秒內完成的自訂函式會失敗，並顯示 Internal error executing the custom function 錯誤。限制自訂函式中的處理量，以打造良好的使用者體驗。盡可能最佳化函式。
  • 自訂函式無法使用需要授權的 Apps Script 服務，如果嘗試使用，系統會傳回 You do not have permission to call X service 錯誤。自訂函式中只能使用許可的服務。
  • 工作表中的每個自訂函式都會分別呼叫 Apps Script 伺服器。如果使用者嘗試在過多儲存格中使用自訂函式，函式可能會執行得較慢。為避免這種情況，請盡可能簡化自訂函式。如果需要函式執行複雜或擴充的處理作業，請不要使用自訂函式，而是改為透過選單項目、對話方塊或側邊欄互動提供該功能。

試算表巨集

巨集可讓您記錄在 Google 試算表中執行的動作，並在日後透過鍵盤快速鍵重複執行這些動作。在試算表中建立巨集後，系統會將巨集新增為與該試算表繫結的 Apps Script 專案中的巨集函式。如要進一步瞭解巨集，請參閱「Google 試算表巨集」。

很抱歉，試算表巨集不能透過外掛程式發布。如果您在外掛程式的資訊清單中加入巨集定義，該外掛程式的使用者就無法使用該定義。