スプレッドシート追記型差分同期の使い方

KOKOCAL SCRIPTのMVP機能は無料で利用できます。ログインは不要です。スクリプト生成フォームに入力したファイルID、シート名、 列名、設定内容、生成スクリプトはサーバーへ保存しません。

同じ設定を後で使いたい場合は、生成画面の「設定保存」からJSONファイルとして手元に保存し、 「設定読込」から復元できます。

このツールは、同期元スプレッドシートの行を同期先スプレッドシートへ値としてコピーするApps Scriptを生成します。 初回は既存行をまとめて同期し、2回目以降はフォーム送信、最終行への手動追記、行の貼り付けを自動検知して処理します。

同期は一方向です。同期先で編集した内容を同期元へ戻すことはなく、双方向同期や競合解決は行いません。

標準方式は「追記型・行位置固定」です。同期元シートへID列、更新日時列、バージョン列などを追加しないため、 Googleフォーム回答シートの列構造を壊さずに導入できます。

1. 1

   同期元と同期先を用意する

   同期元はGoogleフォーム回答シートや、末尾に行を追加して使う通常シートを想定します。同期先シートは値のコピー先として使います。同期は同期元から同期先への一方向です。

2. 2

   フォームに必要事項を入力する

   スプレッドシートID、シート名、列マッピング、バッチ件数を入力します。同期元シートにID列や管理列を追加する必要はありません。

3. 3

   注意事項を確認してスクリプトを生成する

   追記型・行位置固定の前提を確認し、利用規約に同意するとApps Scriptを生成できます。

4. 4

   Apps Scriptへ貼り付ける

   元データ側スプレッドシートのApps Scriptへ生成されたCode.gsを貼り付け、setupSyncSystemを実行します。管理用シートは同期元ファイル内に非表示で作成されます。

5. 5

   元スプレッドシートを再読み込みする

   setupSyncSystemの実行後、元データ側スプレッドシートを再読み込みします。再読み込みすると、上部メニューにKOKOCAL差分同期が表示され、「初期設定を再実行」などのメニューを使えるようになります。

6. 6

   初回同期を実行する

   メニューの初回同期で既存データを同期先へ値として書き込みます。以降はフォーム送信や手動編集イベントをキューに入れて差分同期します。

スクリプト生成後は、生成結果カラム右上の「導入ガイドをダウンロード」から、導入方法、導入後確認事項、生成スクリプト、設定JSONをまとめて保存できます。 ページを離れると生成結果は消えるため、Apps Scriptへ貼り付ける前に保存しておくと、作業途中でも内容を見返しやすくなります。

行数が減った、対象シートのsheetIdが変わった、行位置が崩れた疑いがある場合、スクリプトは PAUSED_INTEGRITY_ERROR として停止します。これは誤った行へ書き込まないための保護です。

復旧するときは、同期元の状態を確認してから「完全再構築」を実行します。完全再構築では、同期先と _SYNC_INDEXを元データから作り直します。