【GAS入門#92】Googleフォームの回答を徹底解析!FormResponse.getItemResponses()の使い方とチェックボックス・日付データの取得術

「Googleフォームで集めたアンケートや申請のデータを、もっとプログラムで細かく柔軟に処理したい……」
「スプレッドシートに飛んできた文字を加工するだけだと、チェックボックスで複数選択された備品や、日付・時間の扱いが地味にめんどくさい!」

社内のDX推進やフォームの自動化を進めていると、一度はこのような壁にぶつかりますよね。

前回(第91回)は、スプレッドシート側の onFormSubmit トリガーを使って、フォームが送信された瞬間にダッシュボード管理シートへデータを自動反映させる方法を学びました。
スプレッドシート連携は手軽で非常に便利ですが、実際の業務では「もっと複雑なフォーム」を扱う機会がたくさんあります。

たとえば、札幌オフィスのスタッフが「社用車(冬道対応4WD)」や「高輝度プロジェクター」「オンライン配信ブース」を同時に複数予約したり、「利用希望日」や「返却時間」を細かく指定して申請してくるようなシチュエーションです。
これをスプレッドシートの文字列だけで判別しようとすると、「カンマ区切りの文字列を分解して、日付の形式を直して……」と、プログラムがどんどん複雑になってしまいますよね。

そこで今回マスターするのが、Googleフォームそのもののオブジェクトをプログラムから直接解析する超重要メソッド FormResponse.getItemResponses() です!

この命令を使えば、Googleフォームに送信された回答を「1問ごとの質問パーツ(アイテム)」として綺麗に分解し、記述テキスト、チェックボックス(配列データ)、日付、時間などを、それぞれのデータ型に合わせて完璧に取り出すことができます。
今回は、札幌オフィスの「設備利用申請フォーム」を題材に、送信されたリクエストを精密に解析して次の自動処理へ繋げるプロの技を、どこよりも分かりやすく徹底解説していきます!

1. そもそも FormResponse.getItemResponses() とは?フォームの階層構造を解剖

まずは、GoogleフォームをGASで操作するときの「階層構造(親子関係)」と、今回の主役である FormResponse.getItemResponses() の位置づけをスッキリ整理しておきましょう。

「家・部屋・家具」の例えで理解するGoogleフォームの構造

本連載でおなじみの例えを、Googleフォームの世界に当てはめてみます。

階層レベル GASでのオブジェクト名 現実世界での例え 役割・中身
全体司令塔 FormApp 役所の窓口 Googleフォーム全体を管理する親玉クラス
フォーム本体 Form 申請用紙のバインダー フォームそのもの(質問項目の設定や回答全体の管理)
1回分の提出回答 FormResponse ★ 提出された1枚の申請書 誰かが送信ボタンを押して提出した「1回分の回答データ」
1問ごとの解答欄 ItemResponse ★本日の主役! 申請書の各記入枠 「氏名」「希望日」「備品」といった1問1問に対する回答パーツ
質問項目そのもの Item 印刷された質問ラベル 「利用希望日」といった質問のタイトルや種類(テキスト、チェックボックス等)

Googleフォームの内部構造を図解すると、以下のようになります。

Form (フォーム本体:設備利用申請フォーム)
│
└── FormResponse (誰かが送信した1回分の申請書)
│
├── ItemResponse (1問目の回答:氏名 ➔ "道産子 太郎")
├── ItemResponse (2問目の回答:利用希望日 ➔ "2026-11-10")
├── ItemResponse (3問目の回答:備品 ➔ ["社用車4WD", "プロジェクター"])
└── ItemResponse (4問目の回答:返却予定時間 ➔ "18:00")

今回学ぶ getItemResponses() は、提出された申請書(FormResponse)を開いて、中に並んでいる「1問ごとの解答欄(ItemResponse の配列)」をごっそり取り出す命令です。

前回(第91回:スプレッドシート連携)との決定的な違い

「前回の e.namedValues と何が違うの?」と疑問に思う方もいますよね。違いを一覧表で比較してみましょう。

比較項目 スプレッドシート側の e.namedValues(第91回) フォーム側の getItemResponses()(今回:第92回)★
コードを書く場所 スプレッドシートに紐づくGASエディタ Googleフォーム本体に紐づくGASエディタ
取得できるデータ シートのセルに書き込まれた文字列 フォームの各パーツに応じた専用オブジェクト
複数選択(チェックボックス) カンマ区切りの1つの文字列になりがち 綺麗なJavaScriptの配列(Array)として取得可能!
質問タイプ(型)の判別 文字としてしか判別できない 日付型、時間型、選択式などを厳密に判別できる
スプレッドシート未連携の場合 シートがなければ動かない シートと連携していなくてもフォーム単体で完全動作!

スプレッドシートを介さずに、フォームが送信されたその場で「社用車の重複がないか」「正しい時間帯が選ばれているか」を厳密にチェックしてメール通知やカレンダー予約へ直結させたいときは、今回の getItemResponses() を使うのがプロの鉄則です!

2. 超重要!質問タイプごとの「返ってくるデータの型」一覧

ItemResponse を取得したあと、中に入っている実際の回答データを取り出すには .getResponse() というメソッドを使います。

var answer = itemResponse.getResponse();

ここで初心者が一番つまずきやすいのが、「質問の種類(テキスト、チェックボックス、日付など)によって、.getResponse() が返すデータの形(型)が全く異なる」という点です。あらかじめ一覧で頭に入れておきましょう!

フォームの質問形式 getResponse() が返すデータの型 具体例 注意点・取り扱いのコツ
記述式(テキスト) 文字列(String) "道産子 太郎" 前後の余白を .trim() しておくと安全
段落(長文テキスト) 文字列(String) "小樽市内への訪問\n冬道のため安全運転" 改行(\n)が含まれる場合がある
ラジオボタン 文字列(String) "札幌営業部" 選ばれた単一の選択肢名がそのまま返る
プルダウン 文字列(String) "午前(9:00〜12:00)" ラジオボタンと同様に単一の文字列が返る
チェックボックス ★超重要! 文字列の配列(Array) ["社用車(4WD)", "プロジェクター"] 文字列ではなく配列になるため、includes() やループで処理する!
日付 文字列(String) "2026-11-10" YYYY-MM-DD 形式の文字列で返る(Date型ではない点に注意)
時間 文字列(String) "17:30" HH:mm 形式の文字列で返る

特に重要なのが チェックボックス です!
1つしか選んでいなくても ["社用車(4WD)"] という「要素が1つの配列」で返ってきますし、3つ選んでいれば要素が3つの配列になります。ここを理解しておくだけで、実行時エラーの9割は回避できますよ!

3. STEP1:準備!「札幌オフィス設備利用申請フォーム」を用意しよう

それでは、実際に手元で動かすための練習用Googleフォームを作成していきましょう!

フォームの作成手順

  1. ブラウザで Google ドライブ を開きます。
  2. 左上の「+ 新規」>「Google フォーム」をクリックします。
  3. フォームのタイトルを 「【札幌オフィス】社内設備・備品利用申請フォーム」 に設定します。
  4. 以下の表の通りに、バラエティ豊かな質問項目を6つ作成してください。
順番 質問のタイトル 質問の形式 選択肢 / 設定内容 必須設定
1 申請者氏名 記述式 (なし) 必須
2 所属部署 ラジオボタン 札幌営業部、開発推進部、マーケティング部、総務部 必須
3 利用希望日 日付 年、月、日 必須
4 利用希望設備(複数選択可) チェックボックス 社用車(4WDスタッドレス)、高輝度プロジェクター、オンライン配信ブース、ポータブル電源 必須
5 返却予定時間 時間 時刻 必須
6 特記事項・行き先 段落 例:定山渓方面へクライアント訪問、勉強会配信など 任意

作成できたら、ブラウザのアドレスバー(URL)を確認してください。
https://docs.google.com/forms/d/【ここの英数字がフォームID】/edit の部分が、このフォーム固有の「フォームID」です。このあとのコードで使いますので、メモ帳などにコピーしておきましょう!

4. STEP2:【実践】getItemResponses() で送信データを1問ずつ丁寧に解析しよう!

準備ができたら、さっそくGASのエディタを開いてプログラムを書いていきましょう!
今回は学習のために、Googleフォームに紐づくコンテナバインドスクリプト(フォーム右上の「︙」>「スクリプト エディタ」)または独立したスクリプトから、最新の回答1件を取得して解析するコードを実行してみます。

1. コードを入力する

エディタ画面のコードをすべて消去し、以下のスクリプトを貼り付けてください。
※ YOUR_FORM_ID_HERE の部分をご自身のフォームIDに書き換えてくださいね。

/**
* 第92回:FormResponse.getItemResponses() の基本動作確認
* 最新の回答データを1問ずつ解析してログに出力します。
*/
function analyzeLatestFormResponse() {
// ① 操作したいGoogleフォームをIDで開く
var formId = "YOUR_FORM_ID_HERE"; // ご自身のフォームIDを入力
var form = FormApp.openById(formId);

// ② フォームに提出されているすべての回答(FormResponse)を取得する
var formResponses = form.getResponses();

// 回答がまだ1件もない場合の安全ガード
if (formResponses.length === 0) {
Logger.log("⚠️ まだ回答が1件も提出されていません。フォームのプレビューから送信テストを行ってください。");
return;
}

// ③ 一番最後に提出された「最新の回答(FormResponse)」を取り出す
var latestResponse = formResponses[formResponses.length - 1];

Logger.log("==========================================");
Logger.log("■ 提出日時: " + latestResponse.getTimestamp());
Logger.log("■ 回答者メアド: " + latestResponse.getRespondentEmail());
Logger.log("==========================================");

// ④ ★本日の主役!回答用紙から「1問ごとの解答欄(ItemResponse)」の配列を取り出す
var itemResponses = latestResponse.getItemResponses();

// ⑤ ループ処理で1問ずつ質問タイトルと回答内容を取り出して表示
for (var i = 0; i < itemResponses.length; i++) {
var itemResponse = itemResponses[i];

// 質問項目(Item)を取得し、そのタイトル名を取得
var questionTitle = itemResponse.getItem().getTitle();

// ユーザーが入力した回答データを取得(型は質問形式による!)
var answer = itemResponse.getResponse();

// ログに出力
Logger.log("【問 " + (i + 1) + "】 " + questionTitle);

// 配列(チェックボックス)か単一文字列かでログの出し方を工夫
if (Array.isArray(answer)) {
Logger.log(" └ 回答タイプ: 配列(複数選択)");
Logger.log(" └ 選択された項目: [" + answer.join(", ") + "]");
} else {
Logger.log(" └ 回答内容: " + answer);
}
}

Logger.log("==========================================");
Logger.log("すべての回答項目の解析が正常に完了しました!");
}

2. フォームからテスト回答を1件送信する

コードを実行する前に、Googleフォームの画面右上の「目のマーク(プレビュー)」をクリックして、テスト回答を1通送信しておきましょう!

  • 申請者氏名:道産子 花子
  • 所属部署:開発推進部
  • 利用希望日:2026/11/10
  • 利用希望設備:「社用車(4WDスタッドレス)」と「高輝度プロジェクター」の2つにチェック!
  • 返却予定時間:17:30
  • 特記事項:サツドラ北8条店近くのサテライトオフィスへ移動してハンズオン勉強会

3. 保存して実行・ログの確認

  1. エディタ上部の「保存(フロッピーアイコン)」をクリックします。
  2. 実行する関数を analyzeLatestFormResponse に合わせて「実行」をクリックします。
  3. 初回実行時はGoogleフォームへのアクセス承認画面が表示されますので、画面の指示に従ってアクセスを「許可」してください(第2回と同様の手順です)。

実行完了後、エディタ下部の「実行ログ」を確認してみましょう!

情報 ==========================================
情報 ■ 提出日時: Tue Nov 03 2026 15:10:22 GMT+0900 (Japan Standard Time)
情報 ■ 回答者メアド:
情報 ==========================================
情報 【問 1】 申請者氏名
情報 └ 回答内容: 道産子 花子
情報 【問 2】 所属部署
情報 └ 回答内容: 開発推進部
情報 【問 3】 利用希望日
情報 └ 回答内容: 2026-11-10
情報 【問 4】 利用希望設備(複数選択可)
情報 └ 回答タイプ: 配列(複数選択)
情報 └ 選択された項目: [社用車(4WDスタッドレス), 高輝度プロジェクター]
情報 【問 5】 返却予定時間
情報 └ 回答内容: 17:30
情報 【問 6】 特記事項・行き先
情報 └ 回答内容: サツドラ北8条店近くのサテライトオフィスへ移動してハンズオン勉強会
情報 ==========================================
情報 すべての回答項目の解析が正常に完了しました!

注目していただきたいのが、問4のチェックボックスです!
複数の設備が ["社用車(4WDスタッドレス)", "高輝度プロジェクター"] という綺麗なJavaScriptの配列として正しく認識されていますね。
これなら、文字の分割処理(splitなど)を手動で書かなくても、そのままプログラムで自在に扱えます!

5. STEP3:【本格実践】設備申請データを精密解析して予約判定&カレンダー自動登録!

基本の取り出し方がマスターできたら、いよいよ実務レベルの自動化システムを構築していきましょう!
今回は、札幌オフィスの総務・IT管理チームが涙を流して喜ぶ以下の「スマート予約ハンドラー」を作成します。

判定ロジック 実行する自動化アクション
① 社用車が含まれているか? 冬期の北海道は路面凍結リスクが高いため、社用車申請が含まれる場合は「総務への承認要請メール」を自動送信する!
② 希望日と返却時間を合体! 「2026-11-10」と「17:30」を組み合わせて、JavaScriptの正式な Date オブジェクトを自動生成する!
③ Googleカレンダーへ自動登録! フェーズ8(第77回)の知識を活用し、札幌オフィスの共有カレンダーへ「備品キープ」の予定を一瞬で登録する!

実践スクリプト:フォーム送信時に動くリアルタイム解析コード

Googleフォームのメニューから開いたスクリプトエディタに、以下の完全版コードを貼り付けてみましょう。

/**
* Googleフォーム送信時に自動起動するイベントハンドラー関数
* (※フォーム側のトリガー設定から「フォーム送信時」に登録して動かします)
*/
function onFormSubmit(e) {
Logger.log("=== 設備利用申請を受信しました(フォーム側解析) ===");

// イベントオブジェクトから提出された FormResponse を取得
// ※フォーム側トリガーの場合、e.response に FormResponse が入っています!
var formResponse = e.response;
var itemResponses = formResponse.getItemResponses();

// -------------------------------------------------------------
// 1. 各質問の回答を「連想配列(Map)」に整理して取り出しやすくする
// -------------------------------------------------------------
var answers = {};
for (var i = 0; i < itemResponses.length; i++) {
var title = itemResponses[i].getItem().getTitle();
var val = itemResponses[i].getResponse();
answers[title] = val;
}

// 変数に取り分け
var applicant = answers["申請者氏名"] || "匿名";
var department = answers["所属部署"] || "未設定";
var useDateStr = answers["利用希望日"]; // 例: "2026-11-10"
var equipments = answers["利用希望設備(複数選択可)"] || []; // 配列!
var returnTime = answers["返却予定時間"] || "18:00"; // 例: "17:30"
var note = answers["特記事項・行き先"] || "なし";

Logger.log("申請者: " + applicant + " (" + department + ")");
Logger.log("希望設備: " + equipments.join(", "));

// -------------------------------------------------------------
// 2. 日付文字列と時間文字列を合体させて Date オブジェクトを作成
// -------------------------------------------------------------
// "2026-11-10" と "17:30" を "2026/11/10 17:30:00" に組み立て
var startDateTime = new Date(useDateStr.replace(/-/g, "/") + " 09:00:00"); // 朝9時開始と仮定
var endDateTime = new Date(useDateStr.replace(/-/g, "/") + " " + returnTime + ":00");

// -------------------------------------------------------------
// 3. 業務ロジック判定:社用車(4WD)が含まれているかチェック!
// -------------------------------------------------------------
// 第15回で学んだ配列の知識を活用!
var hasCar = equipments.some(function(item) {
return item.indexOf("社用車") !== -1;
});

var statusNote = "通常備品(即時確定)";
if (hasCar) {
statusNote = "⚠️ 社用車利用あり(冬道運転・管理者承認要)";
Logger.log("【警告】社用車申請を検知しました。安全運転管理者の確認が必要です。");

// 第32回の知識:総務担当者へ緊急確認メールを自動送信!
GmailApp.sendEmail(
"admin-sapporo@example.com", // 送信先メールアドレス
"【要確認】社用車利用申請が届きました(" + applicant + " 様)",
applicant + " 様より社用車の利用申請が提出されました。\n" +
"■ 利用日: " + useDateStr + "\n" +
"■ 行き先: " + note + "\n\n" +
"冬期スタッドレスおよび運行前点検の確認をお願いします。"
);
}

// -------------------------------------------------------------
// 4. Googleカレンダーへ備品予約予定を自動ブロック(第77回の復習!)
// -------------------------------------------------------------
var calendar = CalendarApp.getDefaultCalendar(); // または第76回のgetCalendarById()
var eventTitle = "【設備予約】" + equipments.join(" / ") + "(" + applicant + ")";
var eventDescription = "申請部署: " + department + "\n" +
"返却予定: " + returnTime + "\n" +
"備考・行先: " + note + "\n" +
"ステータス: " + statusNote;

var event = calendar.createEvent(eventTitle, startDateTime, endDateTime, {
description: eventDescription,
location: "札幌オフィス共用備品庫"
});

Logger.log("Googleカレンダーに予約を登録しました: " + event.getTitle());
}

コードの解説:現場で唸る3つのスマート設計

  1. 連想配列(Map)への変換テクニック:

    冒頭で answers[title] = val; と一度辞書にまとめることで、answers["申請者氏名"] のように直感的な名前でデータにアクセスできるようにしています。質問の順番が入れ替わっても絶対にコードが崩れません。
  2. 配列メソッド .some() を使ったスマート判定:

    チェックボックスで複数選択された equipments(配列)の中に「社用車」が含まれているかを一瞬で判定しています。
  3. 日付と時間の自然な合体:

    日付文字列 "2026-11-10" と時間文字列 "17:30" を結合して、カレンダー登録用の new Date() を正確に生成しています。

6. 実務で差がつく!getItemResponses() のプロ技3選

基本を押さえたところで、現場のリードエンジニアが必ず仕込んでいる「3つの応用プロ技」を伝授します!

プロ技①:質問タイプ(ItemType)ごとに処理を自動分岐させる

「質問のタイトル」だけでなく、「質問の種類(テキストなのか、チェックボックスなのか、日付なのか)」をプログラムで判定したいときは、item.getType() を使用します。

var item = itemResponse.getItem();
var itemType = item.getType();

// 質問タイプに応じた分岐
switch (itemType) {
case FormApp.ItemType.CHECKBOX:
Logger.log("これはチェックボックスの回答です(配列)");
break;
case FormApp.ItemType.DATE:
Logger.log("これは日付項目の回答です");
break;
case FormApp.ItemType.TEXT:
Logger.log("これは1行テキストです");
break;
}

どんな質問が後から追加されても動的に対応できる、超汎用的な汎用アンケート集計スクリプトを作るときに大活躍します!

プロ技②:未回答の任意項目を安全に取り扱う「null合体ガード」

必須項目ではない質問(例:「特記事項」など)にユーザーが何も書かずに送信した場合、itemResponses の一覧からその質問自体がスキップされて含まれないケースがあります。
answers["特記事項"] || "記載なし" のように、デフォルト値を必ず用意しておくことで、undefined による予期せぬエラーを完全にシャットアウトできます。

プロ技③:回答の修正(再送信)時に編集用URLを取得する

FormResponse オブジェクトには、回答者が後から回答を修正できる「回答編集用URL(EditResponseUrl)」を取得するメソッドが用意されています!

// 回答者が後から修正するための専用URLを発行!
var editUrl = formResponse.getEditResponseUrl();
Logger.log("回答の変更・修正はこちらから: " + editUrl);

「あ、返却予定時間を18時から19時に伸ばしたい!」というときに、このURLを申請完了メールに載せておくだけで、ユーザー自身で安全に申請内容を修正してもらえるようになります。

7. 初心者が100%つまずく!5大トラップと完全対処法

FormResponse.getItemResponses() を扱う際、プログラミング初心者やGAS学習者が非常によく遭遇する「5大落とし穴」を厳選しました!困ったときはここを見直してみてくださいね。

トラップ1:チェックボックスを文字列だと思い込んでカンマ区切りで検索して失敗する

// ✕ 間違った書き方
var selected = itemResponse.getResponse();
if (selected.indexOf("社用車") !== -1) { ... } // 運良く動くこともあるが配列のため危険!
// ◯ 正しい書き方(配列として扱う)
var selectedArray = itemResponse.getResponse(); // これは配列!
if (selectedArray.includes("社用車(4WDスタッドレス)")) { ... }

チェックボックスの戻り値は必ず Array(配列) です。文字列操作ではなく、配列メソッド(includes や indexOf、some)を使う癖をつけましょう。

トラップ2:フォーム側のトリガーとスプレッドシート側のトリガーの混同

前回(第91回)のスプレッドシート側トリガーと、今回のフォーム側トリガーでは、届く小包 e の中身が全く異なります!

  • スプレッドシート側:e.namedValues や e.values が届く
  • Googleフォーム側:e.response(FormResponseオブジェクト本体)が届く

Googleフォームのスクリプトエディタで書いているのに e.namedValues を読もうとすると、Cannot read properties of undefined エラーで撃沈します。自分が今どちらのエディタで作業しているかを必ず確認してください。

トラップ3:質問タイトルの一致判定で「余計なスペース」に気づかない

「フォーム側の質問タイトルは『申請者氏名 』と末尾に半角スペースが入っていたのに、コード側では answers["申請者氏名"] と書いていて値が取れない……」というトラブルが頻発します。
フォームの質問文をコピー&ペーストしてコード側に貼り付けるか、比較時に .trim() を通すようにすると安全です。

トラップ4:form.getResponses()[0] で「一番古い回答」を掴んでしまう

// ✕ 昔のテスト回答をつかんでしまう!
var response = form.getResponses()[0];
// ◯ 最後に提出された最新の回答をつかむ!
var responses = form.getResponses();
var latestResponse = responses[responses.length - 1];

配列の先頭 [0] は、何ヶ月も前に送信された「一番最初の回答」です。テスト実行時は必ず responses.length - 1 で末尾の最新データを取得しましょう。

トラップ5:エディタの「実行」ボタンを押して引数 e が空っぽでエラーになる

第91回でもお伝えした通り、トリガー関数 onFormSubmit(e) をエディタの画面から直接「実行」ボタンでテストすると、Googleから e が手渡されないため e is undefined で停止します。
テストする際は、STEP2で作成した analyzeLatestFormResponse() のように FormApp.openById().getResponses() でデータを能動的に引っ張ってくるテスト関数を作るのが、プロの開発スタイルです!

8. 今回のまとめ&次回予告

今回は、Googleフォームの回答用紙を1問ずつ精密に分解して解析する FormResponse.getItemResponses() について徹底解説しました!

本日の重要ポイントおさらい
1. FormResponse.getItemResponses() で1問ごとの回答パーツ(ItemResponse)を取得できる!
2. itemResponse.getResponse() は質問タイプによって型が違う(チェックボックスは配列!)
3. 質問タイトルと回答を連想配列(Map)にまとめると、質問順の変更に強い設計になる!
4. 日付文字列と時間文字列を合体させれば、Googleカレンダーへの自動予約も完璧!
5. フォーム側トリガーのイベントオブジェクトには e.response にデータが入っている!

スプレッドシートの枠を超えて、Googleフォーム本体のデータを自由自在に料理できるようになると、社内システムの信頼性と表現力が一気にアップしますね!
札幌オフィスの設備利用申請も、これで二重予約や管理漏れがゼロの快適なオフィスDXへと進化しました。

さて、自動化システムがどんどん高度になってくると、次に絶対に避けて通れないのが「セキュリティと認証情報の管理」です!

「Slack通知を送るためのWebhook URLや、外部APIのシークレットトークンを、コードの中に直接ベタ書き(ハードコーディング)していませんか……?」
もしそのコードを同僚に共有したり、GitHubに誤って公開してしまったら、セキュリティ事故になってしまいますよね。

そこで次回(第93回)は、大切な秘密鍵やトークンを安全・堅牢に隠して管理する PropertiesService.getScriptProperties() を徹底解説します!
プロのエンジニアとして恥ずかしくない、セキュリティ対策の必須スキルを身につけていきましょう。次回もどうぞお楽しみに!