前回の第33回(GmailApp.search())では、Gmail全体の中からキーワードを使って目的のメールのやり取り(スレッド)を自動検索する方法を学びましたね!
「これで欲しいメールが自由自在に探せるようになった!」と感動した方も多いのではないでしょうか。
しかし、前回の処理で取得できたのは、あくまでメールのやり取り全体を束ねた「スレッド(GmailThread)」という単位でした。
実際の業務や自動化ツール作成では、そのスレッドの中に入っている「1通目の送信者」「2通目の本文」「最新メールの送信日時」といった、1通ごとの具体的なメール情報を取り出したい場面がほとんどですよね。
そこで今回マスターするのが、スレッド(束)の中から含まれているすべてのメールを一括で取り出す重要メソッド GmailThread.getMessages() です!
今回は、札幌オフィスで毎年大盛り上がりする「秋の社員旅行(函館)の打ち合わせメール」を題材に、スレッドとメッセージの違いから、取得した配列データの扱い方、初心者が必ずハマる落とし穴まで、どこよりも分かりやすく徹底解説していきます!
1. そもそも GmailThread と GmailMessage の違いってなに?
GASでGmailを操作するとき、初心者が一番最初につまずきやすいのが 「スレッド(GmailThread)」と「メッセージ(GmailMessage)」の違い です。
ここをあやふやなまま進めてしまうと、「コードは合っているはずなのに本文が取れない…」といったエラーに悩まされることになります。
まずは、本連載でおなじみのイメージを使って、この2つの関係をスッキリ整理しておきましょう!
「クリアファイル」と「中の書類」でイメージしよう!
Gmailの構造は、オフィスでよく使われる「クリアファイルと中の書類」に例えると一気に理解しやすくなります。
GmailThread(スレッド) = 【クリアファイル(束)】- 同じ件名や話題でやり取りされたメールのグループ全体です。表紙(件名)や全体のやり取り数が管理されています。
GmailMessage(メッセージ) = 【クリアファイルに入っている1枚1枚の書類】- スレッドの中に含まれている「1通1通の個別のメール」のことです。差し出し人、本文、送信日時、添付ファイルといった具体的なデータを持っています。
【GmailThread(クリアファイル)】
├── 1枚目の書類(GmailMessage):企画案の提示(件名・本文・送信者)
├── 2枚目の書類(GmailMessage):日程の返信(件名・本文・送信者)
└── 3枚目の書類(GmailMessage):決定事項の確認(件名・本文・送信者)
前回学んだ GmailApp.search() で取得できるのは、あくまで「クリアファイル(GmailThread)」のリストです。
クリアファイルを手に入れただけでは、中の文字を読むことはできませんよね。ファイルを開いて、中の書類を取り出す作業が必要になります。
その「クリアファイルを開いて、中の書類(メッセージ)を全部取り出す」作業こそが、今回学ぶ GmailThread.getMessages() なのです!
2. 本日覚える命令 GmailThread.getMessages() とは?
今回新しく覚える命令の文法と役割を確認しましょう。
var messages = thread.getMessages();
(読み方:ジーメール・スレッド・ゲット・メッセージス)
getMessages() の役割と特徴
指定したスレッド(GmailThread オブジェクト)に対して呼び出すことで、そのスレッド内に含まれているすべてのメール(GmailMessage オブジェクト)を1次元配列(リスト形式)として一括取得する命令です。
語尾の s(複数形)に注目!
第13回(Range.getValues())や第14回(Range.setValues())で学んだ通り、GASにおいて複数形の s がつくメソッドは、結果が配列(箱が並んだリスト)で返ってきます。
たとえメールのやり取りが1通しか存在しないスレッドであっても、getMessages() が返すのは「要素が1つだけ入った配列 [GmailMessage]」になります。
messages[0]➡ スレッドの最初(1通目)のメールmessages[1]➡ スレッドの2通目のメールmessages[messages.length - 1]➡ スレッドの最新(最後)のメール
このように、インデックス番号(0始まり)を指定することで、欲しいメールをピンポイントで取り出すことができます。
3. STEP1:準備!「函館社員旅行の打ち合わせメール」を用意しよう
それでは、実際に手元のGmailを使ってテストデータを準備していきましょう!
今回は、札幌オフィスから特急北斗に乗って出かける「函館社員旅行」のやり取りを想定したスレッドを作成します。
準備手順(テストメールの作成)
- ご自身のGmailを開きます。
- 「作成」ボタンを押し、自分宛て(自分のメードアドレス)に以下の内容でメールを送信します。
- 宛先: 自分のメールアドレス
- 件名:
【札幌オフィス】秋の社員旅行(函館)の打ち合わせ - 本文:
今年の社員旅行は函館に決まりました!移動はJR特急北斗を予定しています。夜食にハセガワストアのやきとり弁当も買いたいですね!
- 届いたメールを開き、「返信」 ボタンを押して自分宛てに返信メールを送信します。
- 返信本文:
賛成です!夕食はラッキーピエロのチャイニーズチキンバーガーも捨てがたいですね。日程調整を進めます!
- 返信本文:
これで、1つのスレッド内に2通のメッセージ(やり取り)が含まれた状態が作れました!
4. STEP2:【実践】スレッド内のメールを一括取得して通数をカウントしてみよう!
準備ができたら、GASのエディタを開いてコードを書いていきましょう。
まずは、第33回で学んだ GmailApp.search() で該当のスレッドを検索し、getMessages() を使って中のメッセージ数をカウントしてみます。
1. コードを入力する
スプレッドシートやGASのスタンドアロンエディタを開き、以下のコードを貼り付けます。
function countHakodateTripMessages() {
// ① 検索条件を指定して「函館社員旅行」のスレッドを取得する(第33回の復習!)
var searchQuery = 'subject:"【札幌オフィス】秋の社員旅行(函館)の打ち合わせ"';
var threads = GmailApp.search(searchQuery);
// 該当するスレッドが見つからなかった場合のガード処理
if (threads.length === 0) {
Logger.log("該当する打ち合わせスレッドが見つかりませんでした。");
return;
}
// ② 一番最初に見つかったスレッド(クリアファイル)を取り出す
var targetThread = threads[0];
// ③【本日の主役!】スレッド内の全メッセージ(書類)を一括取得する
var messages = targetThread.getMessages();
// ④ メッセージ数(配列の長さ)を取得してログに出力する
var messageCount = messages.length;
Logger.log("■ 取得したスレッドの件名: " + targetThread.getFirstUserMessageSubject());
Logger.log("■ このスレッドに含まれるメール通数: " + messageCount + " 通");
}
2. コードの1行ずつ解説!
var threads = GmailApp.search(searchQuery);- 第33回で学んだ検索命令です。検索条件に一致するスレッド(クリアファイル)の配列を取得しています。
var targetThread = threads[0];- 検索結果の配列から、1番目(インデックス
0)のスレッドオブジェクトを取り出して変数targetThreadに代入しています。
- 検索結果の配列から、1番目(インデックス
var messages = targetThread.getMessages();- 今回のメイン!
targetThreadに対して.getMessages()を呼び出すことで、スレッド内に入っている全メールがmessagesという配列に入ります。
- 今回のメイン!
var messageCount = messages.length;- 配列の要素数を表す
.lengthプロパティを使って、「メールが何通入っているか」を数えています。
- 配列の要素数を表す
3. 保存して実行する
- エディタ上部の 「保存(フロッピーアイコン)」 をクリックします。
- 関数が
countHakodateTripMessagesになっていることを確認し、「実行」 を押します。 - 初回実行時はGoogleへのアクセス承認画面が表示されますので、許可を出してください。
4. 実行結果を確認する
画面下の「実行ログ」に以下のように表示されれば大成功です!
情報 ■ 取得したスレッドの件名: 【札幌オフィス】秋の社員旅行(函館)の打ち合わせ
情報 ■ このスレッドに含まれるメール通数: 2 通
1つのスレッドの中から、しっかりと2通のメッセージ(やり取り)が検知できましたね!
5. STEP3:【応用】繰り返し処理(for文)で全メールの情報を順番に取り出してみよう!
getMessages() で取得した結果は配列なので、第11回や第13回で学んだ for 文(繰り返し処理) や forEach() と相性抜群です。
スフレッド内にある「1通目の送信日時」から「最新の返信内容」まで、順番にログへ書き出す応用プログラムを動かしてみましょう!
1. コードを入力する
function printAllMessagesInThread() {
var searchQuery = 'subject:"【札幌オフィス】秋の社員旅行(函館)の打ち合わせ"';
var threads = GmailApp.search(searchQuery);
if (threads.length === 0) return;
// 1番目のスレッドからメッセージ配列を取得
var messages = threads[0].getMessages();
Logger.log("=== 函館旅行打ち合わせスレッド 履歴一覧 ===");
// for文を使って、1通目から順番にメールの情報を出力する
for (var i = 0; i < messages.length; i++) {
var msg = messages[i]; // i通目の GmailMessage オブジェクト
// 次回(第35回)で詳しく学ぶメソッドを先取り使用!
var sender = msg.getFrom(); // 送信者
var date = msg.getDate(); // 送信日時
var snippet = msg.getPlainBody(); // 本文(プレーンテキスト)
Logger.log("【 " + (i + 1) + " 通目のメール 】");
Logger.log("送信者: " + sender);
Logger.log("日時: " + date);
Logger.log("本文抜粋: " + snippet.substring(0, 40) + "..."); // 冒頭40文字だけ表示
Logger.log("--------------------------------------------------");
}
}
2. 実行結果の確認
情報 === 函館旅行打ち合わせスレッド 履歴一覧 ===
情報 【 1 通目のメール 】
情報 送信者: あなたの名前 <your_email@example.com>
情報 日時: Wed Sep 23 2026 10:00:00 GMT+0900 (Japan Standard Time)
情報 本文抜粋: 今年の社員旅行は函館に決まりました!移動はJR特急北斗を予定しています...
情報 --------------------------------------------------
情報 【 2 通目のメール 】
情報 送信者: あなたの名前 <your_email@example.com>
情報 日時: Wed Sep 23 2026 10:05:00 GMT+0900 (Japan Standard Time)
情報 本文抜粋: 賛成です!夕食はラッキーピエロのチャイニーズチキンバーガーも捨てがたい...
情報 --------------------------------------------------
スレッドの中に保管されている過去のやり取りが、1通目から順番に綺麗に分解されて取得できました!
このように配列処理を組み合わせることで、「過去のやり取り履歴をすべてスプレッドシートに書き出して議事録を作成する」といった自動化システムが簡単に構築できるようになります。
6. 初心者が絶対につまずく!4大トラップと完全解決策
GmailThread.getMessages() を使う際、プログラミング初心者の方が必ず一度はハマってしまう4つの落とし穴と、その解決策をまとめました。
トラップ1:GmailApp.getMessages() と書いて TypeError になる
ついついやってしまいがちなのが、以下のような書き方です。
// ✕ 間違った書き方(GmailAppに対して直接呼んでいる)
var messages = GmailApp.getMessages();
// ➡ TypeError: GmailApp.getMessages is not a function
【原因と解決策】
getMessages() は GmailApp(全体の管理者)が持っている命令ではなく、個別の GmailThread(クリアファイル)が持っている命令です。
必ず GmailApp.search() や GmailApp.getThreadById() などでスレッドを取得した後に、そのスレッド変数に対して .getMessages() を呼び出すルールを守りましょう!
トラップ2:二重の配列(threads と messages)で頭がパニックになる
GASでGmailを操作すると、配列の中に配列が登場するため混乱しやすくなります。
GmailApp.search()➡ スレッドの配列[Thread, Thread, Thread]が返るthread.getMessages()➡ メッセージの配列[Message, Message]が返る
【混乱を防ぐコードのコツ】
変数の命名を工夫するのが一番の解決策です。 単数形と複数形を意識して、threads(スレッドたちの配列)、targetThread(ターゲットの1スレッド)、messages(メッセージたちの配列)と名前を明確に区別して書きましょう!
var threads = GmailApp.search(...); // 複数形
var thread = threads[0]; // 単数形
var messages = thread.getMessages(); // 複数形
var firstMsg = messages[0]; // 単数形
トラップ3:メールが1通しかなくても messages[0] と書かなければいけない
「やり取りが1通しか存在しないメールだから」と思って、配列のカッコ [0] をつけずに操作しようとするとエラーが発生します。
// ✕ NG:messagesは「配列」なので、直接本文は取れない!
var body = messages.getPlainBody(); // エラー発生!
// ◯ OK:1通しかなくても [0] を指定して Message オブジェクトを取り出す
var body = messages[0].getPlainBody();
getMessages() の戻り値は常に配列であることを忘れないようにしましょう。
トラップ4:getMessages()(複数形)と getMessage()(単数形)の押し間違い
GASには getMessages() という複数形の命令は存在しますが、getMessage() という単数形の命令は存在しません。
補完機能(予測変換)を使わずに手入力していると、末尾の s を押し忘れて TypeError になるケースが多発します。
キーボードで getMess... まで入力したときに画面に出てくる予測変換を Tab キーで選択して入力するのが確実です!
7. 今回のまとめ&次回予告
今回は、スレッド内の全メールを一括取得する GmailThread.getMessages() について解説しました。
今日の重要ポイントおさらい
GmailThreadは「クリアファイル(束)」、GmailMessageは「1枚の書類(個々のメール)」thread.getMessages()はスレッド内の全メールを1次元配列[GmailMessage]で取得する- メールが1通だけでも配列で返ってくるため、
messages[0]のようにインデックスを指定する for文やforEach()と組み合わせることで、過去のやり取り全通を自動処理できる
「スフレッド(束)」から「メッセージ(1通ごとの便箋)」を取り出すことができたので、Gmail自動化のパズルもいよいよ核心に迫ってきましたね!
さて、取り出した 1通ごとの GmailMessage オブジェクトですが、ここから具体的に「件名」「送信者のメードアドレス」「本文テキスト」を引き出すにはどうすれば良いでしょうか?
次回(第35回)は、今回チラッと先取りした GmailMessage.getSubject() / getBody() を徹底解説します!
届いた「通販で購入した防寒着の確認メール」から件名と本文を自動解析し、スプレッドシートへ綺麗に自動転記する実践的なロジックを作成しますので、ぜひお楽しみに!
