KOKOCAL SCRIPT

Guide

試算表追記型差分同步指南

使用 Google Apps Script 將 Google 表單回覆或追記型管理表,以值的形式進行單向同步的指南。

公開日: 2026年8月1日更新日: 2026年8月6日
追記型・列位置固定

保持來源列的位置,將變更單向同步到目標工作表。

依標題自動同步

目標為空白時,從來源標題列自動判定連續欄位。

同步対象外方式

刪除與結構變更不會反映到同步目標,以保護既有資料。

此生成器適合的用途

此生成器會建立將來源試算表的值複製到同步目標試算表的 Apps Script。

適合 Google 表單回覆或只在末尾新增資料的追記型工作表。

同步為單向。同步目標中的編輯不會反映回同步來源。

同步來源、同步目標與處理條件設定

來源試算表 URL 或 ID

指定要作為來源的 Google 試算表。可貼上完整 URL 或只輸入檔案 ID。

來源工作表名稱

包含處理對象資料的工作表名稱。

同步目標試算表 URL 或 ID

指定同步目標的 Google 試算表。此腳本會由來源單向同步到目標。

同步目標工作表名稱

寫入同步值的目標工作表。空白或新建工作表可不設定欄位對應。

同步目標狀態

目標為空白時使用標題列自動同步。既有工作表才使用欄位對應。

標題列數

來源工作表上方的標題列數。通常為 1。

同步目標開始列

同步目標開始寫入資料的列號。第 1 列為標題時通常指定 2。

最大同步筆數(0 為無限制)

初次同步時處理的最大列數。0 表示不設上限。

初次同步批次列數

初次同步一次讀寫的列數。

差分同步批次件數

差分同步一次處理的變更佇列件數。

重新處理檢查間隔

重新確認尚未同步的變更或暫時錯誤的間隔。

欄位對應

僅在同步到既有目標工作表時使用。

可使用的工作表條件

追記型資料列

適合 Google 表單回覆,或新資料只追加在末尾的業務工作表。

列位置固定

排序、移動列、中途插入列與物理刪除不屬於安全運用前提。

單向同步

值會由同步來源複製到同步目標,同步目標的編輯不會回寫。

導入步驟

1

開啟 Apps Script

從同步來源試算表開啟 Apps Script。

2

建立 KOKOCAL_Menu.gs 與 KOKOCAL_IncrementalSync.gs

在 Apps Script 建立 KOKOCAL_Menu.gs 與 KOKOCAL_IncrementalSync.gs,並將生成內容分別貼上。若已有既有程式碼,請先備份再編輯。

3

執行初期設定

從函數下拉選單選擇 KOKOCAL_IncrementalSync_setup 並手動執行。管理工作表與必要觸發器會建立在來源檔案中。

4

重新載入試算表

KOKOCAL_IncrementalSync_setup 執行後,重新載入來源試算表,使 KOKOCAL 選單顯示。

5

執行初次同步

從選單執行初次同步。目標為空白時,會自動建立標題與值。

儲存導入指南

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

導入後確認事項

1

來源工作表不被修改

確認 setup 前後,來源工作表的欄數與儲存格值沒有變化。

2

表單回覆列

確認新增表單回覆列會進入佇列並追加到同步目標。

3

手動列更新

確認既有列的手動修改會成為 UPDATE 佇列,且只同步目標欄位。

4

列數減少

確認來源列數減少時會安全停止,避免錯誤同步。

5

完整重建

確認可從來源資料重建同步目標與同步索引。

6

機密日誌

確認公司名稱、地址、電話等業務值不會保存到日誌或錯誤內容中。

注意事項

使用前確認

正式使用生成腳本前,請確認此項目。

重要注意事項

正式使用生成腳本前,請確認此項目。

重要注意事項

正式使用生成腳本前,請確認此項目。

使用前確認

正式使用生成腳本前,請確認此項目。

使用前確認

正式使用生成腳本前,請確認此項目。

準備好後前往生成器

針對追記型、列位置固定的運用,從同步來源到同步目標進行單向值同步。

開啟生成器