「社内の備品や会議室の利用申請をGoogleフォームで受け付けているけれど、申請が届いたことに気づくのが遅れてしまう……」
「フォームに送信された内容を手作業でダッシュボードや台帳用スプレッドシートへ転記していて、うっかり二重予約や確認漏れが起きてヒヤヒヤした……」
社内のDX推進や業務効率化を進めていると、このような「フォーム送信後の後続処理の手間」に悩まされる場面が本当によくありますよね。
Googleフォームは、誰でも直感的に回答できて集計も自動で行われるため、社内アンケートや申請窓口として非常に優秀なツールです。しかし、標準機能のままでは「送信されたデータを加工してダッシュボードにリアルタイム反映する」「重複がないか即座に判定する」といった一歩踏み込んだ連動までは自動でやってくれません。
そこで今回からスタートする最終章「フェーズ10:Web API連携 & 最適化編(第91回〜第100回)」の記念すべき第1弾として、フォームが送信されたその瞬間をセンサーのように検知してプログラムを自動起動させる「onFormSubmit(フォーム送信時トリガー)」を徹底解説します!
札幌オフィスの現場で実際に運用されている「札幌オフィス設備利用申請フォーム」を題材に、プロジェクターや社用車、オンライン配信ブースなどの利用申請が届いた瞬間に、前回(第90回)までに構築した統合ダッシュボードへデータを全自動で反映させる仕組みを構築していきます。
初心者の方が100%つまずく「シンプルトリガーとインストール可能トリガーの決定的な違い」から、イベントオブジェクトe.namedValuesの安全な取り扱い方、実務で必須となる重複チェックテクニックまで、どこよりも分かりやすく丁寧に紐解いていきますね!
1. そもそも onFormSubmit とは?フォーム送信を検知する仕組み
まずは、「onFormSubmit とは一体何なのか?」「どうしてフォームが送信された瞬間にプログラムが動くのか?」という根本的な仕組みからスッキリ整理しておきましょう!
Googleフォーム送信を感知する「自動センサー」
Google Apps Script(GAS)には、特定の出来事(イベント)が起きた瞬間にプログラムの引き金を引く「トリガー(Trigger)」という仕掛けが用意されています。
第21回で学んだonOpen(e)(ファイルを開いたとき)や、第22回のonEdit(e)(セルを手動編集したとき)を覚えているでしょうか? これらと同じトリガー仲間のうち、「Googleフォームから回答が送信された瞬間」に自動で起動する専用の仕組みがonFormSubmit(オン・フォーム・サブミット)です。
英語の「Submit(サブミット)」には「提出する・送信する」という意味があります。まさに「フォームが送信されたときに(on Form Submit)」動くセンサーそのものです。
超重要!2種類のトリガー「シンプル」と「インストール可能」の違い
onFormSubmit を学ぶ上で、初心者が最も混乱し、そして実務で重大なトラブルを引き起こしやすいのが「トリガーの種類の選択」です。
GASのフォーム送信トリガーには、実は以下の2つの動かし方があります。
| 比較項目 | シンプルトリガー(function onFormSubmit(e)) | インストール可能トリガー(手動設定)★実務の本命! |
|---|---|---|
| 設定方法 | 関数名をonFormSubmitと書くだけで自動認識 | 時計マーク(トリガー設定画面)から手動で登録 |
| 実行権限 | 制限モード(権限が非常に弱い) | フル権限(スクリプト作成者の権限で動作) |
| Gmail自動送信 | ✕(セキュリティエラーで停止) | ◯(問題なく即座にメール送信可能) |
| 他ファイル・外部API連携 | ✕(別ファイルやSlack連携はブロック) | ◯(他スプレッドシートや外部API通信もOK) |
| おすすめの用途 | セル値の単純計算など極めて限定的な処理 | ダッシュボード反映、通知、メール連携など実務全般 |
「関数名をonFormSubmitにしておけば勝手に動くから楽じゃん!」と思われがちですが、シンプルトリガーは悪意あるプログラムによる情報漏洩を防ぐため、メール送信(GmailApp)や外部通信、別ファイルの操作などの強力な機能がGoogleのセキュリティによって厳格に禁止されています。
そのため、「申請されたデータをダッシュボードに反映させつつ、確認メールを送りたい」「Slackに通知を飛ばしたい」といった実務レベルの自動化を組む場合は、「任意の関数名(例: onFormSubmitTrigger(e))を作成し、時計マークからインストール可能トリガーとして登録する」のが現場での絶対的なスタンダード(鉄則)となります!
イベントオブジェクト「e」に届く宝の山を解剖しよう!
フォームが送信された瞬間、Googleのサーバーは回答内容をひとまとめの小包(イベントオブジェクトe)に詰めてプログラムへ届けてくれます。
スプレッドシートに連携されたフォーム送信トリガーにおいて、小包eの中に入っている代表的なデータは以下の3点です。
| プロパティ名 | データの形式 | どんな情報が入っている? | 取り出しやすさ・特徴 |
|---|---|---|---|
e.namedValues | オブジェクト(連想配列) | { “氏名”: [“佐藤”], “利用設備”: [“プロジェクター”] } | ★一番おすすめ!質問名で直感的に値を取り出せる |
e.values | 配列(Array) | [“2026/11/03 14:00”, “佐藤”, “営業部”, “プロジェクター”] | スプレッドシートの列順に入っている(列変更に弱い) |
e.range | Rangeオブジェクト | 回答が書き込まれた行全体のセル範囲(例: A2:F2) | 背景色を変えたり、隣のセルにステータスを書く時に使用 |
特に実務で圧倒的に重宝するのがe.namedValuesです。質問項目の名前(「氏名」「利用設備」など)をキーにしてデータを取り出せるため、あとからフォームの質問の順番を入れ替えてもプログラムが壊れません。
2. STEP1:準備!「札幌オフィス設備利用申請フォーム」を作成しよう
それでは、実際に手元で動かすためのテスト環境を作っていきましょう!
今回は、札幌オフィスのスタッフが業務で使う「共用設備(高輝度モバイルプロジェクター、社用車(冬道対応4WD)、オンライン商談ブースなど)」を利用申請するGoogleフォームを作成し、スプレッドシートと連携させます。
手順1:Googleフォームの新規作成
- Googleドライブを開き、左上の「+ 新規」>「Google フォーム」をクリックします。
- フォームのタイトルを「札幌オフィス 設備利用申請フォーム」に変更します。
- 以下の通りに、4つの質問項目を作成してください。
| 質問のタイトル | 質問の形式 | 選択肢 / 設定内容 |
|---|---|---|
| 申請者氏名 | 記述式(短文) | (必須に設定) |
| 所属部署 | ラジオボタン または プルダウン | 札幌営業部、開発推進部、マーケティング部、総務部(必須) |
| 利用希望設備 | プルダウン | モバイルプロジェクター、社用車(4WDスタッドレス)、オンライン商談ブースA、VR検証ゴーグル(必須) |
| 利用目的・行先 | 段落(長文) | 例:道内クライアント訪問、勉強会登壇、オンライン採用面接など(任意) |
手順2:回答先スプレッドシートを作成して連携する
- Googleフォーム編集画面の上部にある「回答」タブをクリックします。
- 緑色の「スプレッドシートにリンク」アイコンをクリックします。
- 「新しいスプレッドシートを作成」が選択されていることを確認し、名前を「札幌オフィス設備利用申請管理簿」にして「作成」ボタンを押します。
自動的に新しいスプレッドシートが開き、1行目に「タイムスタンプ」「申請者氏名」「所属部署」「利用希望設備」「利用目的・行先」という見出しが並んだシート(「フォームの回答 1」)が生成されれば準備完了です!
3. STEP2:【実践】onFormSubmit で送信データをリアルタイムにキャッチしよう!
環境が整ったところで、さっそくプログラムを書いていきましょう。
まずは、Googleフォームから回答が送信された瞬間に起動し、届いた小包e.namedValuesの中身をログで確認する基本のスクリプトを作成します。
1. スプレッドシート側のGASエディタを開いてコードを入力
先ほど作成されたスプレッドシートの上部メニューから「拡張機能」>「Apps Script」を開き、エディタ画面に以下のコードを貼り付けます。
/**
* 札幌オフィス設備利用申請フォーム 送信時トリガー関数
* @param {Object} e - フォーム送信時のイベントオブジェクト
*/
function onFormSubmitTrigger(e) {
Logger.log("=== フォーム送信を検知しました ===");
// 安全ガード:万が一イベントオブジェクトが存在しない場合
if (!e || !e.namedValues) {
Logger.log("イベントオブジェクト e.namedValues が取得できませんでした。");
return;
}
// ① e.namedValues から回答データを取得する
// ※超重要:namedValues の中身はすべて「配列」になっているため [0] で取り出す!
var timestamp = e.namedValues["タイムスタンプ"] ? e.namedValues["タイムスタンプ"][0] : "";
var applicant = e.namedValues["申請者氏名"] ? e.namedValues["申請者氏名"][0] : "";
var department = e.namedValues["所属部署"] ? e.namedValues["所属部署"][0] : "";
var equipment = e.namedValues["利用希望設備"] ? e.namedValues["利用希望設備"][0] : "";
var purpose = e.namedValues["利用目的・行先"] ? e.namedValues["利用目的・行先"][0] : "特になし";
// ② ログ画面に出力して確認する
Logger.log("・送信日時 : " + timestamp);
Logger.log("・申請者氏名: " + applicant);
Logger.log("・所属部署 : " + department);
Logger.log("・希望設備 : " + equipment);
Logger.log("・利用目的 : " + purpose);
Logger.log("==================================");
}
コードが貼り付けられたら、エディタ上部の「保存(フロッピーディスクのアイコン)」をクリックして保存します。
2. 超重要!インストール可能トリガーを設定する手順
先ほど解説した通り、この関数は「時計マーク」からトリガー登録を行って初めて自動実行されるようになります。設定手順を1ステップずつ進めましょう!
- GASエディタ画面の左側メニューにある「時計マーク(トリガー)」アイコンをクリックします。
- 右下にある青い「+ トリガーを追加」ボタンをクリックします。
- 設定ダイアログが表示されたら、以下のように指定します。
- 実行する関数を選択:
onFormSubmitTrigger - イベントのソースを選択:「スプレッドシートから」
- イベントの種類を選択:「フォーム送信時」(※ここを必ず「フォーム送信時」にする!)
- エラー通知設定:「毎日通知」または「今すぐ通知」
- 実行する関数を選択:
- 右下の「保存」ボタンをクリックします。
- 初回のみGoogleのセキュリティ認証画面が表示されますので、画面の指示に従ってアクセスを「許可」してください(第2回参照)。
一覧画面に「イベント:フォーム送信時」として登録されれば、自動センサーの設置は完了です!
3. 実際にGoogleフォームからテスト送信してみよう!
それでは、Googleフォームの画面に戻り、右上の「目のマーク(プレビュー)」をクリックして、テスト回答を送信してみましょう!
- 申請者氏名:道産子 太郎
- 所属部署:札幌営業部
- 利用希望設備:社用車(4WDスタッドレス)
- 利用目的・行先:冬道運転による小樽市内クライアント訪問
「送信」ボタンを押したら、GASエディタの画面に戻り、左側メニューの「実行数(再生マーク)」をクリックしてログを確認してみます。
情報 === フォーム送信を検知しました ===
情報 ・送信日時 : 2026/11/03 14:35:10
情報 ・申請者氏名: 道産子 太郎
情報 ・所属部署 : 札幌営業部
情報 ・希望設備 : 社用車(4WDスタッドレス)
情報 ・利用目的 : 冬道運転による小樽市内クライアント訪問
情報 ==================================
人間が何も操作していないのに、フォームが送信された瞬間にGASが自動で飛び起き、届いたデータを完璧に読み取ってくれました! 感動的ですよね!
4. STEP3:【本格実践】ダッシュボード管理シートへ自動加工&リアルタイム反映!
基本が動いたところで、いよいよ本題です!
Googleフォームから送信された生のデータ(「フォームの回答 1」シート)をそのまま使うのではなく、実務では以下のような「加工・整形処理」を行ってから、ダッシュボード用の管理シートへ反映させるのがプロの設計です。
- 管理番号(主キー)の自動採番:
EQ-202611-0001のようなユニークIDを付与する(第90回の設計鉄則!) - 初期ステータスのセット:自動的に「承認待ち」または「予約確定」をセットする
- ダッシュボード専用シートへの転記:Webアプリ(第84回〜第90回)が読み込んでいる「設備稼働モニター」シートへ瞬時に追記する
1. スプレッドシートに「ダッシュボード用シート」を追加する
スプレッドシートの左下の「+」を押し、新しいシートタブを追加して名前を「設備稼働モニター」に変更してください。1行目に以下の見出しを用意します。
| A列(管理ID) | B列(申請日時) | C列(申請者) | D列(部署) | E列(設備名) | F列(ステータス) | G列(備考) |
|---|---|---|---|---|---|---|
| 管理ID | 申請日時 | 申請者 | 部署 | 設備名 | ステータス | 利用目的 |
2. 自動反映スクリプトの完全版コード
コード.gs を開き、以下の完全版スクリプトに書き換えて保存しましょう!
/**
* 札幌オフィス設備利用申請:ダッシュボード自動反映完全版
*/
function onFormSubmitTrigger(e) {
// ① 同時送信によるID重複を防ぐロック処理(第89回・第90回参照)
var lock = LockService.getScriptLock();
lock.waitLock(10000);
try {
if (!e || !e.namedValues) return;
var ss = SpreadsheetApp.getActiveSpreadsheet();
var targetSheet = ss.getSheetByName("設備稼働モニター");
if (!targetSheet) {
targetSheet = ss.insertSheet("設備稼働モニター");
}
// ② フォーム送信データを取り出す
var applicant = e.namedValues["申請者氏名"] ? e.namedValues["申請者氏名"][0] : "匿名";
var department = e.namedValues["所属部署"] ? e.namedValues["所属部署"][0] : "未所属";
var equipment = e.namedValues["利用希望設備"] ? e.namedValues["利用希望設備"][0] : "未指定";
var purpose = e.namedValues["利用目的・行先"] ? e.namedValues["利用目的・行先"][0] : "";
// ③ 日時を読みやすい形式に整形(第29回 Utilities.formatDate)
var now = new Date();
var formattedDate = Utilities.formatDate(now, "Asia/Tokyo", "yyyy/MM/dd HH:mm:ss");
// ④ 管理IDの自動採番(例: EQ-1001)
var lastRow = targetSheet.getLastRow();
var newIdNumber = 1001;
if (lastRow >= 2) {
newIdNumber = 1000 + (lastRow - 1) + 1;
}
var requestId = "EQ-" + newIdNumber;
// ⑤ 設備の特性に応じた初期ステータス判定
// 社用車は「管理者承認待ち」、その他備品は「即時予約確定」にする業務ルール例
var initialStatus = "予約確定";
if (equipment.indexOf("社用車") !== -1) {
initialStatus = "承認待ち";
}
// ⑥ ダッシュボード用シートへ一括自動追記!(第7回 appendRow)
targetSheet.appendRow([
requestId,
formattedDate,
applicant,
department,
equipment,
initialStatus,
purpose
]);
Logger.log("ダッシュボードへ反映完了: " + requestId + " (" + applicant + " 様 - " + equipment + ")");
} catch (err) {
Logger.log("エラー発生: " + err.message);
} finally {
lock.releaseLock();
}
}
3. 動作確認!フォームからもう一度送信してみよう
Googleフォームからもう一度テスト送信を行ってみてください。
送信完了後、スプレッドシートの「設備稼働モニター」シートを開くと……!
フォームの回答シートとは別に、綺麗に整列された「EQ-1001」「2026/11/03 14:40:00」「道産子 太郎」「札幌営業部」「社用車(4WDスタッドレス)」「承認待ち」というデータが一瞬で自動生成されているはずです!
第84回で作成したWebアプリダッシュボードを開いてリロードすれば、この最新データが画面上のウィジェットや一覧テーブルに即座に表示されます。フォーム送信からダッシュボード反映まで、人間が介在する余地は完全にゼロになりました!
5. STEP4:実務で差がつく!フォーム送信トリガー活用のプロ技3選
基本が完璧に動くようになったら、実際のオフィス運用で大活躍する3つの発展テクニックを押さえておきましょう!
プロ技①:申請者へ「受付完了メール」を即座に自動返信(GmailApp連携)
Googleフォームの設定で「メールアドレスを収集する」をONにしておけば、フォーム送信と同時に第32回で学んだGmailApp.sendEmail()を使って、自動返信メールを瞬時に飛ばすことができます!
// フォームで収集したメールアドレス宛に自動返信する処理例
var userEmail = e.namedValues["メールアドレス"] ? e.namedValues["メールアドレス"][0] : "";
if (userEmail) {
var subject = "【札幌オフィス】設備利用申請を受け付けました(" + requestId + ")";
var body = applicant + " 様\n\n" +
"札幌オフィス設備利用申請を受け付けました。\n\n" +
"■ 申請番号: " + requestId + "\n" +
"■ 利用設備: " + equipment + "\n" +
"■ 現在の状況: " + initialStatus + "\n\n" +
"社用車の利用については総務担当者の承認後に確定となります。";
GmailApp.sendEmail(userEmail, subject, body);
}
「申請がちゃんと届いているかな?」という社員の不安を一発で解消できるため、社内CS(満足度)が劇的に向上します。
プロ技②:e.namedValues を使うことで「質問の並び順変更」に強い設計にする
初心者はついついe.values[1]のように配列の番号(インデックス)でデータを取り出しがちです。しかし、後から「あ、所属部署の前に社員番号の質問を追加しよう」とフォーム側を修正した瞬間、配列の順番がズレてしまい、プログラムが全く意図しないデータを取り込む大事故につながります。
今回のようにe.namedValues["利用希望設備"][0]という「質問タイトル指定」を徹底しておけば、フォーム側で質問の追加や並び替えがどれだけ発生しても、1行もコードを書き直す必要がありません。
プロ技③:Googleカレンダーへ予定を即座に自動登録(Calendar連携)
フェーズ8(第76回〜第80回)で学んだカレンダー連携を思い出してください! 申請された希望日時をもとに、第77回のcalendar.createEvent()を呼び出せば、「設備予約カレンダー」へ自動で予定枠をブロックする完全自動化も数行足すだけで実現できます。
6. 初心者が100%つまずく!onFormSubmit の5大トラップと完全対処法
onFormSubmit を使い始めた開発者が、必ずと言っていいほど一度はハマってしまう「典型的な5大トラップ」をまとめました。トラブルが起きたときはここをチェックしてください!
トラップ1:GASエディタの「実行」ボタンを押してエラーで爆死する
GASエディタで関数を選んで「実行」ボタンを押した瞬間、画面に以下の赤文字エラーが出ます。
TypeError: Cannot read properties of undefined (reading 'namedValues')
【原因】
エディタの実行ボタンを押したときは、「人間がボタンを押しただけ」なので、Googleフォームから回答小包eが届いていません(eの中身が undefined になっています)。
【解決策】
onFormSubmit トリガー関数は、エディタの実行ボタンからテストすることはできません! 必ず実際のGoogleフォームを開き、プレビュー画面からテスト回答を「送信」して動作確認を行ってください。
トラップ2:e.namedValues の中身が「配列」であることを知らずにバグる
これも非常に多い見落としです!
// ✕ 間違った取り出し方(配列そのものが入ってしまう)
var applicant = e.namedValues["申請者氏名"];
// ➔ applicant の中身は "道産子 太郎" ではなく ["道産子 太郎"] になる!
// ◯ 正しい取り出し方(必ず [0] をつける)
var applicant = e.namedValues["申請者氏名"][0];
Googleフォームには「チェックボックス(複数回答)」があるため、GASはすべての回答を安全のために「配列」に入れて届けてくれます。単一回答の質問であっても、必ず末尾に[0]を付けて中身の文字列を取り出しましょう。
トラップ3:フォーム側の質問文を少し書き換えたらデータが消える
Googleフォーム側で、質問タイトルを「申請者氏名」から「お名前(フルネーム)」に修正したとします。すると、コード側のe.namedValues["申請者氏名"]というキーが存在しなくなるため、データが空っぽ(undefined)になってしまいます。
【対策】
フォームの質問文を変更したときは、必ずGASコード側の["質問文"]の文字列も完全に一致するように更新してください。
トラップ4:トリガーを二重に設定して同じ処理が2回動いてしまう
関数名をfunction onFormSubmit(e)としたまま、時計マークからも「フォーム送信時」トリガーを追加してしまうと、1回の送信に対して「シンプルトリガー」と「インストール可能トリガー」の両方が発火し、データが2行重複して書き込まれる怪現象が起きます。
【対策】
インストール可能トリガーを使うときは、関数名をonFormSubmitTrigger(e)やhandleFormSubmit(e)のように、予約名(onFormSubmit)と少し変えておくのがプロの安全テクニックです。
トラップ5:フォームに紐づくGAS(フォーム側)とシート側GASの混乱
GASは「Googleフォームの拡張機能」からも「スプレッドシートの拡張機能」からも作ることができます。今回のようにスプレッドシートへの追記やダッシュボード連携を行う場合は、必ず「スプレッドシート側のApps Script」で作成・トリガー設定してください。
7. 今回のまとめ&次回予告
今回は、Googleフォーム送信時にリアルタイムでプログラムを自動起動させるonFormSubmit(フォーム送信時トリガー)の仕組みと、ダッシュボードへの自動反映テクニックを解説しました!
- onFormSubmitは、フォーム送信をセンサーのように検知して即座に動くトリガー機能!
- 実務では、権限制限のない「インストール可能トリガー(時計マークから登録)」を使うのが鉄則!
- 質問項目の並び替えに強くするため、データ抽出には
e.namedValues["質問名"][0]を使う! - スプレッドシートの最下行へ
appendRow()で流し込むことで、Webダッシュボードへリアルタイム同期できる! - テストする際はエディタの実行ボタンではなく、「実際のフォーム送信」で行う!
これまで手作業で行っていた「フォームの回答を確認して、台帳を開いて、ステータスを入力して……」というルーティンワークが、回答者が送信ボタンを押した瞬間にすべて全自動で終わる心地よさを、ぜひ手元で実感してみてくださいね!
さて、今回はスプレッドシート側から回答データを受け取るアプローチを学びましたが、Googleフォームそのものをプログラムから深く制御したい場面もありますよね。
次回(第92回)は、Googleフォームの本体を直接操作して回答オブジェクトを緻密に解析する「FormResponse.getItemResponses() × 送信された申請データを徹底解析」をお届けします!
フォームの質問タイプ(テキスト、グリッド、日付、チェックボックス)ごとにデータを正確に取り分ける高度な解析テクニックを学んでいきますので、次回もどうぞお楽しみに!
