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

Google 試算表是雲端式服務 這個試算表解決方案提供即時協作功能和強大的工具, 以視覺化方式呈現、處理及傳遞資料

你可以加入外掛程式來擴充試算表,自訂工作流程,改善工作流程。 與第三方系統建立連線,並整合 Google 試算表資料 與其他 Google Workspace 應用程式 (例如 Google 簡報)。

您可以查看其他人使用 Google Workspace Marketplace

建議做法

以下是擴充 Google 試算表的外掛程式功能:

  • 你可以在 Google 試算表中讀取、編輯資料、以圖表呈現資料,以及設定資料格式 使用內建 Apps Script 試算表服務。 該服務還可讓您建立及修改條件式格式設定和資料 驗證規則
  • 您可以使用 Apps Script 進階試算表服務 直接存取 Google Sheets API
  • 您可以建立自訂選單並 定義多個自訂對話方塊和側欄 介面。
  • 您可以在以下項目中加入自訂函式定義: 外掛程式。
  • 您可以使用外掛程式「觸發條件」,在 某些觸發事件會發生什麼情況

試算表外掛程式是以 Apps Script 建立。進一步瞭解如何存取 以及使用 Apps Script 管理 Google 試算表、參閱 擴充 Google 試算表

工作表結構

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

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

觸發條件

Apps Script 觸發條件可允許指令碼專案 在特定條件滿足時執行指定函式,例如當 試算表的開啟或外掛程式。

詳情請參閱外掛程式觸發條件。 瞭解試算表外掛程式可使用哪些觸發條件及適用的限制 相關用途

自訂函式

Google 試算表有許多 內建函式 例如 SUMAVERAGE,可從 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 試算表巨集

不過,試算表巨集「無法」透過外掛程式發布。如果使用 這個巨集定義無法由外掛程式的使用者存取 外掛程式。