KOKOCAL SCRIPT

Guide

KOKOCAL QUiCK PANEL 指南

說明如何在 Google Drive 建立自架 Apps Script 函式庫,並在 Google 試算表、簡報或文件中加入輕量轉接程式。

公開日: 2026年8月12日更新日: 2026年8月13日
自架函式庫

核心側邊欄與資料庫邏輯保留在使用者自己的 Google Drive 函式庫專案中。

跨應用共通側邊欄

在 Google 試算表、簡報與文件使用同一個定型輸入資料庫側邊欄。

Dispatch 包裝

HtmlService 呼叫會經由用戶端 dispatch 函數進入,而不是直接呼叫函式庫內部。

此生成器的用途

此生成器會建立 KOKOCAL QUiCK PANEL 的用戶端轉接程式。

生成檔案同時包含函式庫專案用檔案,以及各目標 Google 檔案中使用的小型用戶端轉接檔案。

它也是今後 KOKOCAL SCRIPT 自架函式庫使用版生成器的第一個標準模式。

函式庫與側邊欄動作的固定設定

選單顯示語言

Google 應用程式選單與對話框或面板中顯示的語言。

用戶端轉接程式與 dispatch 設計

函式庫 Identifier

新增 KOKOCAL Apps Script 函式庫時,固定 Identifier 使用 KOKOCAL_QUICK_PANEL_LIB。

生成器輸入

生成器頁面只需要選擇選單語言。輸入模式、快取與列數上限皆為固定值。

預設動作

輸入會寫入游標或目前儲存格,支援時會取代選取文字。資料庫讀取快取 5 分鐘,每個分頁最多讀取 1,000 列。

輕量轉接程式

生成檔案會在目標 Google 檔案中提供選單、診斷與 KOKOCAL_QuickPanel_dispatch。

跨應用輸入

函式庫會依目前使用的應用程式與選取狀態,處理試算表、簡報與文件中的輸入。

導入步驟

1

從 Google Drive 建立函式庫 Apps Script

在任意 Google Drive 資料夾建立新的 Apps Script 檔案,並作為 QUiCK PANEL 函式庫專案保存。

2

貼上函式庫檔案

建立 KOKOCAL_QuickPanel_Library.gs 與 KOKOCAL_QuickPanel_Sidebar.html,並貼上生成的函式庫內容。需要時將 appsscript-library.json 反映到 appsscript.json。

3

建立函式庫版本並複製 Script ID

保存函式庫專案後建立版本,並複製專案 Script ID。各目標檔案會用此 ID 新增函式庫。

4

從目標檔案開啟 Apps Script

開啟要使用 QUiCK PANEL 的 Google 試算表、簡報或文件,從擴充功能開啟 Apps Script。

5

新增自架函式庫

以複製的 Script ID 新增函式庫。Identifier 請設定為 KOKOCAL_QUICK_PANEL_LIB,並選擇剛建立的版本。

6

建立 KOKOCAL_Menu.gs 與 KOKOCAL_QuickPanel_Client.gs

建立相同名稱的 Apps Script 檔案並貼上個別檔案用內容。需要時將 appsscript-client.json 反映到 appsscript.json。

7

手動執行 KOKOCAL_QuickPanel_setup

在函數下拉選單選擇 KOKOCAL_QuickPanel_setup 並執行,完成授權與函式庫診斷。請勿手動執行 onOpen。

8

重新載入並開啟 QUiCK PANEL

重新載入 Google 檔案後,從 KOKOCAL 選單開啟 QUiCK PANEL。

儲存導入指南

生成腳本後,可從生成結果欄右上方的「下載導入指南」儲存導入所需資訊。離開頁面後生成結果會消失,因此建議在導入前先儲存。

導入後確認事項

1

函式庫診斷

從 KOKOCAL 選單開啟診斷,確認 Identifier、連線狀態與版本資訊。

2

資料庫登錄

登錄含有標籤、屬性與值欄位的試算表資料庫,並在側邊欄切換資料庫與工作表分頁。

3

搜尋與複製

依標籤、屬性或值搜尋,並確認可複製選取值。

4

跨應用輸入

確認可輸入到試算表目前儲存格、簡報文字範圍,以及文件游標或選取範圍。

注意事項

需要設定自架函式庫

生成檔案分為函式庫用檔案與用戶端轉接檔案。請先在使用者自己的 Google Drive 中建立函式庫專案。

試算表資料庫權限

沒有已登錄試算表資料庫讀取權限的使用者,無法在側邊欄顯示資料。

QUiCK PANEL 固定設定

生成器頁面只需要選擇選單語言。函式庫 Identifier 為 KOKOCAL_QUICK_PANEL_LIB,輸入模式會寫入游標或取代選取文字,資料庫讀取快取 5 分鐘,每個分頁最多讀取 1,000 列。

輸入位置取決於選取狀態

在簡報與文件中,部分游標位置、選取範圍或選取物件無法插入文字。請保留複製功能作為替代方式。

資料庫登錄資訊會依使用者保存

目前實作會使用 PropertiesService.getUserProperties() 保存資料庫清單。這已取代舊版 DocumentProperties 的檔案內共用設計。

準備好後前往生成器

在自己的 Google Drive 建立自架 Apps Script 函式庫,並用它為 Google 試算表、簡報與文件加入共通定型輸入側邊欄。

開啟生成器