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

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

您可以透過外掛程式擴充 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 試算表外掛程式，以及使用時有哪些限制，請參閱外掛程式觸發條件。

自訂函式

Google 試算表內建多項函式，例如 SUM 和 AVERAGE，可從 Google 試算表儲存格內叫用。試算表外掛程式可以定義其他自訂函式，補充這些內建函式。使用者安裝外掛程式後，外掛程式中定義的任何自訂函式都會立即生效。外掛程式可能只包含自訂函式定義。如要與他人分享自訂函式定義，主要方法是發布含有定義的外掛程式。

建立外掛程式自訂函式

外掛程式指令碼專案中定義的任何函式，都可以做為自訂函式使用。實作函式並安裝外掛程式後，您就可以呼叫自訂函式，就像呼叫任何其他內建的 Google 試算表函式一樣：在試算表儲存格中輸入 =，然後輸入函式名稱和任何必要參數。如果沒有錯誤，函式傳回的結果會放在 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 試算表巨集」。

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