容器繫結指令碼

如果指令碼符合 Google 試算表、文件、簡報或表單檔案，系統會將其繫結至 Google 試算表、文件、簡報或表單檔案 建立，而非獨立指令碼。 已繫結指令碼的附加檔案稱為「容器」。 已繫結的指令碼大致上類似獨立指令碼，但 不會顯示在 Google 雲端硬碟中，也無法從檔案中卸離 這些 ID 繫結至上層檔案，並獲得一些特殊權限。

請注意，指令碼也可以繫結至 Google 協作平台，但這些指令碼是 幾乎一律會部署為網頁應用程式。字集 繫結至 Google 試算表、文件、簡報或表單也可以變成網頁應用程式。 這很罕見

注意： 繫結指令碼實際上是取消發布。 外掛程式 繫結的檔案。

建立繫結指令碼

Google 文件、試算表或簡報

如要在 Google 文件、試算表或簡報中建立繫結指令碼，請在以下位置開啟文件： 「文件」、「試算表」或「Google 簡報」中的簡報，然後依序按一下 擴充功能 >>「Apps Script」。如何重新開啟指令碼： 重複相同步驟或開啟 Apps Script 資訊主頁。

Google 表單

如要在 Google 表單中建立繫結指令碼，請開啟表單 然後按一下「更多」圖示 > 指令碼 編輯器。如何重新開啟中的指令碼： 重複相同步驟或開啟 Apps Script 資訊主頁。

注意： clasp 工具無法建立繫結指令碼。 但可以複製並進行編輯。

特殊方法

繫結指令碼可以呼叫幾個獨立指令碼無法呼叫的方法：

• getActiveSpreadsheet()、 getActiveDocument()、 getActivePresentation()、 和 getActiveForm() 允許繫結的指令碼參照其上層檔案，而不參照 檔案的 ID
• getUi 可讓您 繫結指令碼存取上層檔案的使用者介面，以便新增 自訂選單、對話方塊和側欄。
• 在 Google 試算表 getActiveSheet() 中， getActiveRange()、 和getActiveCell() 讓指令碼決定使用者目前的工作表、所選儲存格範圍，或 已選取個別儲存格 setActiveSheet(sheet)敬上 和 setActiveRange(range) 讓指令碼變更這些選項
• 在 Google 文件、getActiveTab() 中， getCursor()和 getSelection() 讓指令碼決定使用者目前的分頁、使用者的 或選取的文字setActiveTab(tabId)、 setCursor(position) 和setSelection(range) 讓指令碼變更這些選項

詳情請參閱 Google 試算表擴充指南或 擴充 Google 文件功能指南。

注意： 這些方法僅適用於繫結於 指令碼編輯器、選單項目、對話方塊、側欄或觸發條件。內部 指令碼是以網頁應用程式形式執行，或透過 Apps Script API 規範，以下方法則不包含 。

自訂選單、對話方塊和側欄

繫結指令碼可以藉由在 Google 試算表、文件和表單中新增 自訂選單和 對話方塊或側欄。請注意 但指令碼只能與 與目前開啟檔案的執行個體也就是與一份文件繫結的指令碼 不會影響其他文件的使用者介面。

外掛程式也可以新增自訂選單、對話方塊和側欄。 建議您使用 獨立指令碼。

外掛程式

外掛程式可以在 Gmail、Google 試算表、文件 簡報和表單。如果您開發了邊界或 想與全世界分享這個指令碼 可以用 Apps Script 將指令碼發布為 外掛程式，其他使用者就能從外掛程式商店安裝。

觸發條件

繫結指令碼可以使用簡易觸發條件 例如特殊的 onOpen() 函式，可在 由具有編輯權限的使用者開啟。和所有指令碼類型一樣 並使用可安裝的觸發條件

自訂函式

自訂函式是 您使用 語法 =myFunctionName()。因此自訂函式與 Google 試算表的內建函式 例如 AVERAGE 或 SUM，但由您定義 自訂函式的行為

存取繫結的指令碼

只有具備容器編輯權限的使用者，才能執行繫結指令碼。 只有檢視權限的協作者無法開啟指令碼。 編輯者，但如果要複製容器檔案 並查看及執行該指令碼的副本。

如要瞭解如何共用指令碼的容器檔案，請參閱透過 Google 雲端硬碟。

所有容器繫結的指令碼都使用相同的擁有者、檢視者和 為容器檔案定義的編輯者存取權清單。容器擁有者會 新指令碼專案的擁有權。