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

Google 試算表是雲端試算表解決方案，具備即時協作和強大的工具，可視覺化、處理和傳送資料。

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

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

建議做法

您可以使用擴充 Google 試算表的外掛程式進行下列操作：

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

工作表結構

Google 試算表包含一或多份工作表。每張工作表基本上是 2D 儲存格的方格，可儲存文字、數字、連結或其他值。一或多個相鄰儲存格的群組稱為「範圍」。

Apps Script 試算表服務提供數種類別來代表 Google 試算表中的機構結構 (例如 Sheet 和 Range)。您可以使用這些類別來讀取及修改試算表的資料和行為。

觸發條件

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

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

自訂函式

Google 試算表有許多內建函式，例如 SUM 和 AVERAGE，可從 Google 試算表儲存格中叫用。試算表外掛程式可以定義其他自訂函式來補充這些內建函式。使用者安裝外掛程式後，系統會立即使用外掛程式內含的任何已定義自訂函式。外掛程式可能會只包含自訂函式定義。自訂函式定義主要透過發布包含定義的外掛程式，與其他使用者共用。

建立外掛程式自訂函式

外掛程式指令碼專案中定義的任何函式都可用來當做自訂函式。函式實作完畢且安裝外掛程式後，您可以像任何其他內建試算表函式一樣呼叫自訂函式：在試算表儲存格中輸入 =，後面加上函式名稱和任何必要參數。如果沒有錯誤，函式傳回的結果會放在工作表儲存格中，並視需要溢位至鄰近儲存格。

在外掛程式中建立自訂函式時，請遵循一般自訂函式指南：

此外，在外掛程式中定義的自訂函式有一些特殊注意事項：

  • 為函式命名時，請嘗試建立不重複的名稱，該名稱可能與外掛程式名稱相關聯。如果兩個以上的已安裝外掛程式定義了名稱相同的自訂函式，則使用者只能使用其中一個。
  • 外掛程式應清楚說明外掛程式提供的自訂功能。請務必為自訂函式提供正確的 JSDoc 註解，讓 Apps Script 能夠向使用者顯示自動完成資訊。此外，請考慮在外掛程式本身或外掛程式支援網頁上提供自訂函式的其他說明文件。
  • 在 30 秒內未完成的自訂函式會失敗，並顯示 Internal error executing the custom function 錯誤。限制自訂函式中執行的處理量，藉此打造良好的使用者體驗。盡可能將函式最佳化。
  • 自訂函式無法使用需要授權的 Apps Script 服務，如果嘗試執行，自訂函式也會失敗並顯示 You do not have permission to call X service 錯誤。請僅在自訂函式中使用允許的服務。
  • 工作表中的每個自訂函式都會對 Apps Script 伺服器發出單獨呼叫。如果使用者嘗試在太多儲存格中使用自訂函式，函式的執行速度可能會比較慢。為減緩此問題，請盡可能簡化自訂函式。如果您需要該函式執行複雜或擴充處理作業，請勿使用自訂函式，而是透過選單項目、對話方塊或側欄互動提供這項功能。

試算表巨集

巨集可讓您在 Google 試算表中錄製動作，稍後再透過鍵盤快速鍵重複執行。在工作表中建立巨集後，系統會將巨集以巨集函式的形式加入至該工作表的 Apps Script 專案。如要進一步瞭解巨集，請參閱「Google 試算表巨集」一文。

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