【GAS入門#37】処理済みメールを自動で既読化!GmailMessage.markRead()の使い方と実践テクニック

毎日届くたくさんのメール。受信トレイを開くと「未読」を示す数字がずらりと並んでいて、少しモヤモヤした気持ちになったことはありませんか?

本連載の「フェーズ4:Gmail連携・メール自動配信」では、これまでメールの自動送信(第31回)から、特定のメールの自動検索(第32回)、スレッド内のやり取りの一括取得(第33回)、件名や本文の読み取り(第34回)、添付ファイルの取り出し(第35回)まで学んできました。

GASを使ってメールの本文や添付データを自動でスプレッドシートに書き込めるようになると、業務は劇的に効率化します。しかし、ここで1つ大きな問題が発生します。

「プログラムで処理し終わったメールが、受信トレイに『未読』のまま残り続けてしまう」 という点です。

未読のままだと「どれが処理済みで、どれが未処理なのか」が人間から見ても分からなくなりますし、次回プログラムを実行した際に同じメールを何度も重複して処理してしまう原因にもなります。

そこで今回マスターするのが、自動処理が終わったメールにプログラムから「既読マーク」を付与する GmailMessage.markRead() です!

今回は、行政からの定期連絡である「【札幌市からのお知らせ】」から件名がはじまるメールを題材に、プログラムで内容を確認・自動処理したあと、サッとスマートに既読化する一連の流れを分かりやすく解説していきますね!

1. そもそも GmailMessage.markRead() とは?

GmailMessage.markRead() は、Gmail内の特定のメール(1通の手紙=Message)に対して、プログラムから「既読」の状態に変更する(既読フラグを立てる)ための命令(メソッド)です。

コードの基本構造

// メッセージオブジェクトに対して実行する
message.markRead();

これまでの連載でお伝えしてきた「Gmailの階層構造」を覚えているでしょうか?

GASでGmailを扱うときは、以下の3つのレベル(階層)を意識することが大切です。

階層レベルオブジェクト名現実世界での例え主な役割
全体GmailApp郵便局メールの検索、送信、下書き作成など
まとまりGmailThread往復のやり取りが入った「回覧封筒」スレッド全体の操作、ラベル付与など
1通GmailMessage封筒の中に入っている「1通の手紙」 ★今回の主役件名・本文の取得、差出人確認、既読化など

markRead() は、この中の GmailMessage(1通の手紙) が持っている命令です。

プログラムでメールを開封し、中の文字(本文)を読み取ったあとに「この手紙はもう読んだよ!」とチェック印(既読)を押すイメージですね。

2. なぜ自動化において「既読化」が超重要なのか?

「別に未読のままでも、データさえ取れれば問題ないのでは?」と思うかもしれません。

しかし、実務でGASを定期実行(トリガーによる自動化)させる場合、メールの既読化はシステムの安定動作に欠かせない「超重要ステップ」になります。

その理由は、主に以下の2つです。

① 重複処理(二重送信や二重書き込み)を防止するため

GASで「新しく届いたメールだけを処理したい」とき、検索条件に is:unread(未読メールのみ)を指定するのが鉄板のテクニックです。

もしプログラムでデータを取得したあとに既読化(markRead())を行わないとどうなるでしょうか?

次に5分後や1時間後にプログラムが自動実行されたとき、過去に処理したはずのメールが「未読」のまま残っているため、再び検索に引っかかってしまいます。

その結果、スプレッドシートに同じデータが何重にも書き込まれたり、相手に重複して返信メールが飛んでしまったりという重大なトラブルにつながるのです。

② 受信トレイの視認性を保つため

人間がGmailを開いたとき、処理済みのメールが未読(太字表示)のままだと、「まだ対応していない重要メールがあるのでは?」と混乱してしまいます。

プログラムが裏で処理してくれたメールを自動で既読にしておくことで、自分の受信トレイを常にすっきり保つことができます。

3. STEP1:準備!テスト用メールを用意しよう

それでは、実際に手元のGmailとGASを使って動作を確認していきましょう!

今回は「札幌市からのお知らせ」を模したテストメールを用意します。

手順

  1. 自分宛てにテストメールを送信するお使いのGmailアカウントから、自分自身のメールアドレス宛に以下のテストメールを2〜3通送信してください。
    • 1通目の件名:【札幌市からのお知らせ】大通公園の春イベント開催について
    • 2通目の件名:【札幌市からのお知らせ】冬の除雪作業とごみ収集日程変更
    • 本文:(「テストです」「確認用」など適当な文字でOKです)
  2. 受信トレイで「未読」状態になっているか確認する自分から自分宛てに送ると、自動的に既読になってしまう場合があります。その場合は、受信トレイでメールの左側にあるチェックボックスを選択し、上部メニューの「未読にする」アイコン(手紙を開いていないマーク)を押して、件名が太字(未読状態)になっていることを確認してください。

4. STEP2:【実践】「【札幌市からのお知らせ】」メールを自動で既読にしてみよう!

準備ができたら、GASのエディタ画面を開いてコードを書いていきましょう。

今回は、第32回で学んだ GmailApp.search() で未読の「【札幌市からのお知らせ】」メールを検索し、第34回のように件名をログに出力したうえで、仕上げに markRead() で既読化するプログラムを作成します。

1. コードを入力する

スプレッドシートや独立したGASエディタ(Apps Script)を開き、以下のコードをコピー&ペーストしてください。

function autoReadSapporoNotices() {
  // ① 検索クエリ:未読(is:unread)かつ件名が「【札幌市からのお知らせ】」で始まるメールを検索
  var searchQuery = 'is:unread subject:"【札幌市からのお知らせ】"';
  
  // ② 該当するスレッド一覧(まとまり)を取得
  var threads = GmailApp.search(searchQuery);
  
  // 該当するメールが1件もない場合の処理
  if (threads.length === 0) {
    Logger.log("未読の『札幌市からのお知らせ』メールは見つかりませんでした。");
    return;
  }
  
  Logger.log("該当するスレッド数: " + threads.length + " 件が見つかりました。処理を開始します。");
  
  // ③ スレッドを1つずつ順番に処理するループ(第33回の復習)
  for (var i = 0; i < threads.length; i++) {
    // スレッド内のメッセージ(1通ごとの手紙)配列を取得
    var messages = threads[i].getMessages();
    
    // ④ スレッド内の各メッセージを順番にチェックするループ
    for (var j = 0; j < messages.length; j++) {
      var message = messages[j];
      
      // メッセージが「未読」の場合のみ処理を実行する
      if (message.isUnread()) {
        var subject = message.getSubject();
        var date = message.getDate();
        
        // ログに自動処理したメールの情報を表示(スプレッドシートへの書き込み等の代わり)
        Logger.log("【処理完了】件名: " + subject + "(受信日時: " + date + ")");
        
        // ★本日の主役!メールを「既読」にする
        message.markRead();
      }
    }
  }
  
  Logger.log("すべての対象メールの自動処理と既読化が完了しました!");
}

2. コードのポイントを徹底解説!

1行ずつ処理のポイントを紐解いていきましょう!

  • var searchQuery = 'is:unread subject:"【札幌市からのお知らせ】"';Gmailの検索ボックスに入力する検索式と同じ構文です。is:unread を指定することで、「まだ読まれていないメール」のみに限定して取得しています。
  • if (message.isUnread()) { ... }message.isUnread() は、そのメッセージが未読であれば true、既読であれば false を返してくれる判定コマンドです。安全のために「未読であること」を再確認してから処理を行っています。
  • message.markRead();ここで取得したメッセージに対して markRead() を実行しています。この1行が動いた瞬間に、Gmailサーバー上の該当メールの「未読フラグ」が外れ、画面上でも既読状態へと変化します。

3. 保存して実行する

  1. 画面上部の 「保存アイコン(フロッピーディスク)」 をクリックします。
  2. 実行する関数が autoReadSapporoNotices になっていることを確認し、「実行」 ボタンをクリックします。

初回実行時の「承認プロセス」について

Gmailの読み取りや変更を行うプログラムを初めて実行する際は、Googleアカウントのアクセス許可(承認ポップアップ)が表示されます。

  1. 「権限を確認」 をクリックします。
  2. 自分のGoogleアカウントを選択します。
  3. 「このアプリは Google で検証されていません」と表示されたら、左下の 「詳細」 をクリックします。
  4. 下部に表示される 「無題のプロジェクト(安全ではないページ)に移動)」 をクリックします。
  5. 最後に 「許可」 をクリックします。

※第2回や第31回でも体験したセキュリティチェックですので、安心して進めてくださいね。

4. 実行結果を確認してみよう!

実行が終わったら、エディタ下部の「実行ログ」と、実際のGmail受信トレイを確認してみましょう。

【実行ログの表示例】

情報    該当するスレッド数: 2 件が見つかりました。処理を開始します。
情報    【処理完了】件名: 【札幌市からのお知らせ】大通公園の春イベント開催について(受信日時: Fri Jan 23 2026 ...)
情報    【処理完了】件名: 【札幌市からのお知らせ】冬の除雪作業とごみ収集日程変更(受信日時: Fri Jan 23 2026 ...)
情報    すべての対象メールの自動処理と既読化が完了しました!

【Gmail受信トレイの様子】

Gmailの画面に戻って受信トレイを更新してみてください。

先ほどまで太字(未読)で表示されていた「【札幌市からのお知らせ】」のメールが、メールを開いていないのにもかかわらず、通常の細字(既読)に一瞬で変わっているはずです!

さらに、もう一度GAS側で「実行」ボタンを押してみてください。

今度はログに以下のように表示されます。

情報    未読の『札幌市からのお知らせ』メールは見つかりませんでした。

先ほど既読化したため、is:unread の検索条件から外れ、二重処理が綺麗に防止できていることが確認できましたね!

5. 知っておくと得する!関連メソッドとスレッド単位の既読化

markRead() を使いこなすうえで、合わせて覚えておくと役立つテクニックや関連命令を2つご紹介します。

① あえて「未読」に戻す:GmailMessage.markUnread()

markRead() の対になる命令として、markUnread()(マーク・アンリード) も存在します。

// メッセージを「未読」状態に戻す
message.markUnread();

たとえば、「プログラムで一次処理(分類やログ記録)は行ったけれど、人間の目で後から確認してほしい重要なメール」などの場合に、あえて最後に message.markUnread() を実行して未読に戻しておく、といった運用で活用できます。

② スレッド全体を一括で既読にする:GmailThread.markRead()

今回紹介した GmailMessage.markRead() は「1通の手紙」を既読にする命令ですが、実は GmailThread(スレッド=往復のやり取り全体) にも markRead() という同名の命令が用意されています。

// スレッドに含まれるすべてのメッセージを一気に既読化する
thread.markRead();

スレッド内に何通もやり取りがぶら下がっている場合、1通ずつループを回さなくても、thread.markRead() を1回呼び出すだけで、そのスレッドに含まれる過去の全メールを一括で既読化できます。

状況に応じて、以下のように使い分けるとスマートです。

  • 特定メッセージだけを厳密に既読にしたいとき ➡ GmailMessage.markRead()
  • やり取り全体をまとめて既読にして整理したいとき ➡ GmailThread.markRead()

6. 初心者が絶対につメインド!4大トラップと完全対処法

GmailMessage.markRead() を使用する際、初心者がよくつまずくエラーやトラブルと、その解決策をまとめました。

トラップ1:GmailApp.markRead() と書いて TypeError になる

最も多い間違いが、親玉である GmailApp に対して直接 markRead() を呼び出してしまうパターンです。

// ✕ エラーになる書き方(GmailApp には markRead はない)
GmailApp.markRead();

// ◯ 正しい書き方(メッセージまたはスレッドオブジェクトに対して実行する)
message.markRead();

【解決策】

markRead() は「どのメールを既読にするか」という対象が必要な命令です。

必ず GmailApp.search() などを経由して取得した message(メッセージ) や thread(スレッド) の変数に対して呼び出しましょう。

トラップ2:検索クエリから is:unread を忘れて永久ループ・大量実行になる

検索クエリを組み立てる際、is:unread をつけ忘れて subject:"【札幌市からのお知らせ】" だけにしてしまうケースです。

// ✕ NG:過去の既読メールまで毎回すべて取得してしまう
var searchQuery = 'subject:"【札幌市からのお知らせ】"';

// ◯ OK:未読メールだけを狙い撃ちする
var searchQuery = 'is:unread subject:"【札幌市からのお知らせ】"';

is:unread がないと、過去何ヶ月分もの既読メールを毎回すべて取得してしまい、プログラムの処理時間がどんどん長くなってしまいます。定期自動化を組む際は、必ず is:unread をセットで入れる癖をつけましょう!

トラップ3:処理途中でエラーが起きると既読化まで届かない

プログラム内でデータの計算やスプレッドシートへの書き込みを行っている最中にエラーが発生すると、プログラムが途中で強制終了し、最後の message.markRead() まで到達しません。

その結果、メールが未読のまま残り、次回実行時に再びエラーを繰り返す負のループに入ってしまうことがあります。

【解決策】

確実にメールを処理したい場合は、第30回で学んだ try...catch 構文 を使ってエラーハンドリングを行いましょう。

try {
  // スプレッドシートへの書き込みなどの処理
  writeToSheet(message);
  
  // 処理が成功した場合のみ既読化する
  message.markRead();
} catch (e) {
  Logger.log("処理中にエラーが発生しました: " + e.message);
  // エラー時はあえて既読にせず、未読のまま残して人間に気付かせる!
}

トラップ4:大量のメールが一気に届いて「6分の壁(実行時間上限)」に引っかかる

GASには「1回の実行時間は最長6分まで」という制限があります。未読メールが何百通も溜まっている状態でループ処理を回すと、既読化処理の途中で制限時間に達して停止してしまうことがあります。

【解決策】

大量のメールを処理する場合は、GmailApp.search(searchQuery, 0, 20) のように一度に処理する件数を上限(例:20件まで)に絞って取得・処理するか、スレッド一括既読(thread.markRead())を使って処理回数を減らしましょう。

7. まとめ&次回予告

今回は、自動処理したメールに既読マークをつける GmailMessage.markRead() の使い方と実践テクニックを解説しました!

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

  1. GmailMessage.markRead() は1通のメール(Message)を既読にする命令
  2. 自動化において「処理済み=既読化」にすることは、二重処理の防止と安全動作に不可欠
  3. 検索クエリに is:unread を組み合わせることで、未読メールだけを効率的に自動処理できる
  4. スレッド全体をまとめて既読にしたい場合は GmailThread.markRead() も活用できる

これで、「メールを探す ➡ 本文や情報を取得する ➡ 自動処理する ➡ 既読にして整理する」という、Gmail自動化の完璧な黄金サイクルが完成しましたね!

次回(第38回)は、メールの分類や整理に欠かせない GmailThread.addLabel() を解説します!

「スープカレー部」や「重要案件」といったオリジナルラベルをメールのやり取りに自動で付与し、Gmailの受信トレイを視覚的にも超スマートに整理するテクニックを学んでいきましょう。次回もぜひ楽しみに待っていてくださいね!