Apps Script プロジェクトを統合する手順と注意点（初心者向けまとめ）

はじめに：GASのコードを「まとめたい！」と思ったら

Google スプレッドシートやフォームに紐づけた Apps Script（GAS）を運用していると、
「別のプロジェクトで作ったコードを統合したい！」という場面が出てきます。

でも、ただコピペすればいい…というわけではありません。
設定ファイルのマージや、関数名の競合といった初心者がつまずきやすいポイントがあります。

この記事では、私自身が実際に統合作業をしたときの流れを、
「疑問 → 解決」形式でまとめました。
これから同じ作業をする方の参考になれば嬉しいです。

手順① プロジェクトの準備

まずは統合先（最終的に使いたいスプレッドシートに紐づいたGASプロジェクト）を開きます。
そこに別プロジェクトからコードをコピーして追加していきます。

👉 ポイント

• .gs ファイルは複数OK。役割ごとにファイルを分けるとわかりやすい

• appsscript.json は1つしか存在できないので、後でマージが必要

手順② appsscript.json を統合する

ここが最初のハマりポイント。
片方の appsscript.json を丸ごと追加することはできません。

疑問と解決

• timeZone が Asia/Tokyo と America/New_York で違うけど？
  　→ 実運用に合わせて Asia/Tokyo に統一しました。

• oauthScopes はどう扱う？
  　→ 新しいコードで必要な権限だけを追加しました。

手順③ コードをコピーする

別プロジェクトにあった .gs ファイル（例：Gemini.gs, Main.gs, Setup.gs, Sheet.gs）を統合先に追加。
中身をコピー＆ペーストします。

疑問と解決

• ファイル名を appsscript.gs にしてもいい？
  　→ NGです。この名前は予約済み。
  　→ 機能がわかる名前（例：Gemini.gs, Setup.gs）にしました。

手順④ 関数名の競合チェック

複数のコードをまとめると、同じ関数名が被ってエラーになることがあります。

疑問と解決

• どうやって関数名を一括検索する？
  　→ Apps Scriptエディタはファイル単位の検索しかできません。
  　→ そこで clasp でローカルに clone → VSCode（Cursor）で Ctrl+Shift+F 検索をしました。

手順⑤cmdで最初のフォルダを作る（Cursorで開くための準備）

Apps Script を clasp でローカルに clone するとき、私は最初ここでつまずきました。
いきなり clasp clone <スクリプトID> を実行したら、Dev フォルダ直下にファイルが散らばってしまったんです。

「え？ Dev の中にプロジェクト用のフォルダができるんじゃないの？」と勘違いしていました。
結果、appsscript.json や .gs ファイルが全部 Dev の直下に出てきて、「あれ、整理されてない…」と困惑しました。

正しい手順（私のやり直し方法）

1. まず cmd を開く
   Windows なら「スタート → cmd」でOK。

2. 作業フォルダに移動
   今回は Dev というフォルダを作業場所にしました。以下を実行：

cd C:\Users\私のフォルダ\Dev

1. プロジェクト専用フォルダを作る
   たとえば Highlighter という名前にしました。以下を実行：

mkdir Highlighter cd Highlighter

その中でクローンを作成します。以下を実行：

clasp clone <スクリプトID> 

失敗から学んだこと

• clone は「今いるフォルダ直下」にファイルを展開する

• だから、clone の前に必ず 自分でプロジェクト用のフォルダを作って、その中に移動しておくこと が大事

もし私と同じように「Dev直下にファイルが散らばった」場合は、手動でまとめてもOKですが、
最初から mkdir でフォルダを作っておけばスピーディかつスッキリします。

👉 これで、Cursor で開くときも Highlighter フォルダをまるごと指定すればOK。
「最初の一歩」でつまずかないために、ここはぜひ押さえておきたいポイントです。

手順⑥ 重複関数の解消

実際に調べたら、Setup.gs に同じ名前の setupMinimal() が2つ。

• 1つ目 → テスト用に使っていた軽量版

• 2つ目 → 本番で使う完成版

👉 対応
テスト版はコメントアウトして残し、本番版を採用。
将来の参考資料も兼ねて削除はしませんでした。

手順⑥ clasp push で反映

ローカルで修正した内容を Google Apps Script に反映するには、Ctrl＋Sで保存した後に、以下を実行：

clasp push

手順⑦ 動作確認とトリガー再設定

最後に、統合したコードを実際に動かして確認します。

• ブラウザのApp Scriptをリロード

• Apps Script エディタで関数を手動実行 → エラーが出ないかチェック

• 必要に応じてトリガー（時間トリガーや onOpen など）を再設定
  👉 トリガーはコピーされないので、統合先で新規設定が必須です。

まとめ：統合の流れと学び

Apps Script の統合は「ただのコピペ」では済みません。

• appsscript.json のマージ

• 関数名の重複確認と解消←Cursorを使うとらくらく

• clasp での反映とテスト

この3つがカギになります。

私自身も作業中に、

• 「appsscript.gs という名前は使える？」

• 「同じ関数 が2つあるけどどうする？」

• 「Dev直下にファイルが展開されたけど手動で整理していい？」

といった疑問にぶつかりました。
この記事が、同じように迷う人の参考になれば嬉しいです。

🔜次回予告

Obsidian　初期設定を解説予定です！
📌 フォローしてお待ちいただけると嬉しいです！
今後も、生成AIツールの使い始めの疑問を解決するようなnoteを更新していきます。

👤 筆者について
日々、生成AIを使って業務ツールや自動化を試行錯誤中。
「昨日の自分を助けるnote」を書いてます。

🧡 スキやコメントで応援いただけると励みになります！
🔁 Xでシェアしてもらえると泣いて喜びます！