【GAS入門#34】スレッド内の全メールを一括取得!GmailThread.getMessages()の使い方と配列処理

前回の第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を使ってテストデータを準備していきましょう!

今回は、札幌オフィスから特急北斗に乗って出かける「函館社員旅行」のやり取りを想定したスレッドを作成します。

準備手順(テストメールの作成)

  1. ご自身のGmailを開きます。
  2. 「作成」ボタンを押し、自分宛て(自分のメードアドレス)に以下の内容でメールを送信します。
    • 宛先: 自分のメールアドレス
    • 件名: 【札幌オフィス】秋の社員旅行(函館)の打ち合わせ
    • 本文: 今年の社員旅行は函館に決まりました!移動はJR特急北斗を予定しています。夜食にハセガワストアのやきとり弁当も買いたいですね!
  3. 届いたメールを開き、「返信」 ボタンを押して自分宛てに返信メールを送信します。
    • 返信本文: 賛成です!夕食はラッキーピエロのチャイニーズチキンバーガーも捨てがたいですね。日程調整を進めます!

これで、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 に代入しています。
  • var messages = targetThread.getMessages();
    • 今回のメイン! targetThread に対して .getMessages() を呼び出すことで、スレッド内に入っている全メールが messages という配列に入ります。
  • var messageCount = messages.length;
    • 配列の要素数を表す .length プロパティを使って、「メールが何通入っているか」を数えています。

3. 保存して実行する

  1. エディタ上部の 「保存(フロッピーアイコン)」 をクリックします。
  2. 関数が countHakodateTripMessages になっていることを確認し、「実行」 を押します。
  3. 初回実行時は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を操作すると、配列の中に配列が登場するため混乱しやすくなります。

  1. GmailApp.search() ➡ スレッドの配列 [Thread, Thread, Thread] が返る
  2. 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() について解説しました。

今日の重要ポイントおさらい

  1. GmailThread は「クリアファイル(束)」、GmailMessage は「1枚の書類(個々のメール)」
  2. thread.getMessages() はスレッド内の全メールを1次元配列 [GmailMessage] で取得する
  3. メールが1通だけでも配列で返ってくるため、messages[0] のようにインデックスを指定する
  4. for 文や forEach() と組み合わせることで、過去のやり取り全通を自動処理できる

「スフレッド(束)」から「メッセージ(1通ごとの便箋)」を取り出すことができたので、Gmail自動化のパズルもいよいよ核心に迫ってきましたね!

さて、取り出した 1通ごとの GmailMessage オブジェクトですが、ここから具体的に「件名」「送信者のメードアドレス」「本文テキスト」を引き出すにはどうすれば良いでしょうか?

次回(第35回)は、今回チラッと先取りした GmailMessage.getSubject() / getBody() を徹底解説します!

届いた「通販で購入した防寒着の確認メール」から件名と本文を自動解析し、スプレッドシートへ綺麗に自動転記する実践的なロジックを作成しますので、ぜひお楽しみに!