Apps Script 基礎
什麼是 Apps Script
Apps Script 是 Google 的腳本執行環境，可為 Google 試算表、Google 簡報等加入自訂選單、處理與自動化。KOKOCAL SCRIPT 會生成貼到 Apps Script 使用的腳本。
綁定型腳本
多數生成器會從目標試算表或簡報開啟 Apps Script，並將腳本綁定到該檔案。這樣容易在目標檔案中顯示選單或側邊欄，但每個要使用的檔案都需要導入。
.gs 與 HTML 檔案
Apps Script 本體請貼到生成結果顯示的 .gs 檔案，例如 KOKOCAL_Menu.gs 與 KOKOCAL_<功能名>.gs。使用側邊欄或畫面元件的生成器，還需要追加 KOKOCAL_SlidesLayerPanelView.html 等 HTML 檔案。若生成結果顯示檔案名稱，請用相同名稱建立。
初次授權
第一次執行時，會要求 Google 帳號授權。請確認讀寫目標檔案、顯示 UI、建立觸發條件等必要權限後再允許。
導入流程
- 1
開啟目標檔案
開啟要使用生成腳本的 Google 試算表、Google 簡報等。
- 2
開啟 Apps Script
從擴充功能選單開啟 Apps Script。若已有程式碼，請先備份再貼上。
- 3
建立必要檔案
請依生成結果顯示的檔案名稱建立 KOKOCAL_Menu.gs、KOKOCAL_<功能名>.gs 與必要的 HTML 檔案。
- 4
保存並執行初始設定
保存後，執行指定的初始設定函數或選單建立函數。
- 5
重新載入原始檔案
選單追加型腳本需要重新載入目標檔案，才會反映到上方選單。
- 6
執行導入後確認
依生成結果的確認事項，在測試用檔案或已備份檔案中確認動作。
生成結果包含導入指南下載功能。離開頁面前先保存，即可之後一起回看導入方法、確認事項、程式碼與 JSON。
注意事項
建立備份
會變更資料的腳本，執行前請複製檔案並保留備份。尤其是一括整形或同步處理更為重要。
確認既有 KOKOCAL_Menu.gs 與觸發條件
在同一專案加入多個腳本時，請確認 KOKOCAL_Menu.gs、registerMenu 函數與觸發條件是否重複。
確認權限含義
授權畫面可確認腳本會存取哪些 Google 服務。不清楚時，請先用測試用檔案確認。
注意處理量與執行時間
Apps Script 有執行時間與讀寫次數限制。處理大量資料時，請將批次件數與目標範圍設得保守一些。
常見問題
選單沒有顯示
執行初始設定函數後，請重新載入目標檔案。KOKOCAL_Menu.gs 會透過 onOpen 建立共通選單，因此需要重新載入。
找不到 HTML 檔案
側邊欄型腳本除了 .gs 檔案，還需要建立 HTML 檔案。檔案名稱的大小寫也要與生成結果一致。
授權時停止
依個人帳號或組織設定，可能會出現警告。請確認是自己生成的程式碼，並先在測試用檔案執行。
多個腳本發生衝突
請確認 KOKOCAL_Menu.gs、registerMenu 函數、觸發條件與共通函數名是否重複。同時使用多個腳本時，請參考專用指南。
Guide
相關指南
確認 Apps Script 基礎後，也建議確認畫面閱讀方式與同時使用多個腳本時的注意事項。