前回(第33回・第34回)までの連載では、Gmailから目的のメールのやり取り(スレッド)を検索する GmailApp.search() や、そのスレッドから個々のメールを取り出す GmailThread.getMessages() について詳しく学んできましたね。
「メールの塊(スレッド)」から「1通のメール(メッセージ)」を掴むところまで進んだら、次にやりたくなるのは「メールの中身(件名や本文)をプログラムで読み取って、業務やログに活用すること」です!
たとえば、
- 「ネット通販で購入した防寒ギアや冬物ウェアの注文確認メールから、件名と金額を抜き出したい」
- 「問い合わせメールの本文から連絡先や注文番号を自動で抽出して、スプレッドシートに一覧化したい」
- 「毎朝届くシステム通知メールの件名をチェックして、特定の警告が含まれていたらSlackに転送したい」
といった自動化は、実務でもプライベートでも超・定番の活用シーンです。
そこで今回は、Gmailの1通のメッセージから件名を取得する GmailMessage.getSubject() と、本文を取得する GmailMessage.getBody()(およびプレーンテキストを取得する getPlainBody())を徹底解説します!
北海道の本格的な冬に向けてオンラインショップで防寒着を購入した際の「注文確認メール」を題材に、基礎知識から実務で使えるデータ抽出テクニック、初心者がハマりやすい落とし穴まで、どこよりも分かりやすく丁寧に紐解いていきますね!
1. そもそも GmailMessage.getSubject() / getBody() とは?
今回学ぶメソッドは、どちらも1通のメールオブジェクト(GmailMessage)に対して実行する命令です。
クラスの階層構造をおさらいしよう
GASでGmailを操作するときは、以下のような「箱の中に箱が入っている」階層構造になっています。
- 【全体】GmailApp(Gmail全体の親玉)
- 【束】GmailThread(同じ件名のメールがまとまった「スレッド / 封筒の束」)
- 【1通】GmailMessage(1通の「手紙 / メッセージ」)★今回の操作対象!
getSubject()➡ メールの件名(タイトル)を取得するgetBody()/getPlainBody()➡ メールの本文を取得する
- 【1通】GmailMessage(1通の「手紙 / メッセージ」)★今回の操作対象!
- 【束】GmailThread(同じ件名のメールがまとまった「スレッド / 封筒の束」)
「手紙と便箋」の例えでイメージを掴もう!
1通のメール(GmailMessage)を手にしたとき、
getSubject()は、「便箋の1行目に書かれた件名(タイトル)を読むこと」getBody()は、「便箋に書かれた本文そのものを読むこと」
にあたります。
2. 違いを徹底整理!getBody() と getPlainBody() の使い分け
メールの本文を取得する命令には、getBody() と getPlainBody() の2種類が存在します。名前が似ているため混同しやすいですが、取得できるデータ形式が全く異なります。
| メソッド名 | 取得できる内容 | 特徴と主な用途 |
GmailMessage.getSubject() | 件名(文字列) | メールのタイトルを取得する |
GmailMessage.getBody() | HTML形式の本文 | <div> や <b> などのHTMLタグ、装飾、画像埋め込みを含む本文を取得する。※メールをそのまま別の宛先へ転送・再装飾したい時に使用 |
GmailMessage.getPlainBody() | プレーンテキスト形式の本文 | 装飾やHTMLタグが一切含まれない「純粋な文字だけ」の本文を取得する。 ★実務でのデータ抽出・解析・スプレッドシート転写ではこちらが100%おすすめ! |
なぜ実務では getPlainBody() を使うべきなの?
最近のネット通販や企業メールの多くは、見た目が綺麗な「HTMLメール」で届きます。
getBody() を使って本文を取得すると、<html><body><p>ご注文ありがとうございます</p>... のように余計なプログラム用タグが大量に混ざってしまいます。
プログラムで「合計金額」や「注文番号」といった特定の文字を検索・抽出したい場合は、余計なHTMLタグが排除された getPlainBody() を使うのが鉄則です!
3. STEP1:準備!「通販で購入した防寒着の注文確認メール」を用意しよう
それでは、実際のコードを動かすための事前準備をしましょう。
手順
- ご自身のGmailを開きます。
- 自分宛てに(または別のアカウントから)テスト用のメールを1通送信します。
- 宛先:自分のGmailアドレス
- 件名(Subject):
【北国ギアショップ】ご注文ありがとうございます(注文番号:100234) - 本文(Body):Plaintext
道産子アウトドアストアをご利用いただきありがとうございます。 以下の内容でご注文を承りました。 【ご注文内容】 ・商品名:極暖防寒ロングダウンコート ・サイズ:L ・数量:1 ・お支払い合計金額:29,800円 商品は準備ができ次第、札幌配送センターより発送いたします。
- メールを受信トレイで確認できたら準備完了です!
4. STEP2:【実践】メールの件名と本文を取得してログに表示してみよう!
準備ができたら、スプレッドシートからGASのエディタを開いて、件名と本文(プレーンテキスト)を取り出すスクリプトを書いていきましょう。
1. コードを入力する
Googleスプレッドシートのメニューバーから 「拡張機能」 > 「Apps Script」 を開き、エディタ画面のコードをすべて消して以下を貼り付けます。
function getMailSubjectAndBody() {
// 1. 件名に「北国ギアショップ」が含まれるスレッドを検索する
var threads = GmailApp.search("北国ギアショップ");
// 該当するメールが見つからない場合の安全対策
if (threads.length === 0) {
Logger.log("該当するメールが見つかりませんでした。");
return;
}
// 2. 検索結果の1番目(最新)のスレッドを取得する
var latestThread = threads[0];
// 3. スレッド内のメッセージ一覧を取得する(配列で返る)
var messages = latestThread.getMessages();
// 4. 最新のメッセージ(配列の最後)を取り出す
var latestMessage = messages[messages.length - 1];
// 5. 件名(Subject)と本文(PlainBody)を取得する
var subject = latestMessage.getSubject();
var plainBody = latestMessage.getPlainBody();
// 6. 実行ログに出力して確認!
Logger.log("=== メールの件名 ===");
Logger.log(subject);
Logger.log("=== メールの本文(プレーンテキスト) ===");
Logger.log(plainBody);
}
2. コードを1行ずつ徹底解説!
var threads = GmailApp.search("北国ギアショップ");- 第33回で学んだ検索命令です。検索条件に合うスレッドの配列を取得します。
var messages = latestThread.getMessages();- 第33回で学んだ命令です。スレッドの中に入っている1通ごとのメッセージ(
GmailMessage)を配列として取り出します。
- 第33回で学んだ命令です。スレッドの中に入っている1通ごとのメッセージ(
var latestMessage = messages[messages.length - 1];- スレッド内で一番最後に届いた「最新のメッセージ」をピンポイントで指定しています。
var subject = latestMessage.getSubject();- 本日の主役その1!メッセージから件名(文字列)を取り出します。
var plainBody = latestMessage.getPlainBody();- 本日の主役その2!メッセージからHTMLタグを含まない純粋な本文テキストを取り出します。
3. 保存して実行する
- エディタ上部の 「保存(フロッピーアイコン)」 をクリックします。
- 関数が
getMailSubjectAndBodyになっていることを確認し、「実行」 をクリックします。 - 実行ログを確認してみましょう!
【実行結果の確認】
情報 === メールの件名 ===
情報 【北国ギアショップ】ご注文ありがとうございます(注文番号:100234)
情報 === メールの本文(プレーンテキスト) ===
情報 道産子アウトドアストアをご利用いただきありがとうございます。
以下の内容でご注文を承りました。
【ご注文内容】
・商品名:極暖防寒ロングダウンコート
・サイズ:L
・数量:1
・お支払い合計金額:29,800円
商品は準備ができ次第、札幌配送センターより発送いたします。
GASがメールから見事に件名と本文を抜き出してくれました!
5. STEP3:実務で差がつく!メール本文から「合計金額」を抜き出してスプレッドシートに自動追記しよう
件名や本文が文字列として取得できたら、次にやりたくなるのは「本文の中から特定のデータ(金額や注文番号)だけを抜き出して、スプレッドシートに整理・蓄積すること」ですよね!
ここでは、第17回で学んだ文字列操作 String.split() や正規表現、第7回で学んだ Sheet.appendRow() を組み合わせた実践的な応用プログラムを作成してみましょう。
実践コード:メールから「注文番号」と「合計金額」を抜き出してシートに自動追記
function parseOrderMailAndAppend() {
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getActiveSheet();
// 1. 目的のメールを検索して最新メッセージを取得
var threads = GmailApp.search("北国ギアショップ");
if (threads.length === 0) return;
var messages = threads[0].getMessages();
var message = messages[messages.length - 1];
var subject = message.getSubject();
var body = message.getPlainBody();
// 2. 件名から「注文番号」を抜き出す(正規表現を使用)
// 例:「注文番号:100234」から数字部分だけをキャプチャ
var orderNoMatch = subject.match(/注文番号:(\d+)/);
var orderNo = orderNoMatch ? orderNoMatch[1] : "不明";
// 3. 本文から「合計金額」を抜き出す
// 例:「お支払い合計金額:29,800円」から金額テキストを抽出
var priceMatch = body.match(/お支払い合計金額:([0-9,]+)円/);
var price = priceMatch ? priceMatch[1] : "不明";
// 4. 受信日時を取得
var date = message.getDate();
// 5. スプレッドシートの一番下にデータを自動追記!(第7回 appendRow)
sheet.appendRow([date, orderNo, subject, price]);
Logger.log("スプレッドシートにデータを出力しました!注文番号: " + orderNo + " / 金額: " + price);
}
スプレッドシートへの出力結果
| 受信日時 | 注文番号 | 件名 | 合計金額 |
| 2026/09/23 10:15 | 100234 | 【北国ギアショップ】ご注文ありがとうございます… | 29,800 |
このように、getSubject() や getPlainBody() で取得した文字列に対して検索処理(正規表現や split)をかけることで、手作業でのコピー&ペースト作業を完全にゼロにすることができます!
6. 初心者が絶対につまずく!4大トラップと完全対処法
メールの中身を取得する際、プログラミング初心者の方が非常によく直面するエラーやトラブルを4つまとめました。あらかじめ対処法を知っておくと安心です!
トラップ1:GmailThread に対して getSubject() を実行して叱られる
// ✕ エラーになる書き方(Threadに対して呼び出している)
var threads = GmailApp.search("北国ギアショップ");
var subject = threads[0].getSubject();
// エラーメッセージ:TypeError: threads[0].getSubject is not a function
【原因と対処法】
getSubject() や getBody() は、GmailMessage(1通の手紙)オブジェクトが持っている命令です。
threads[0] は GmailThread(封筒の束) なので命令が存在しません。
必ず thread.getMessages() でメッセージの配列を取り出し、messages[0].getSubject() のように メッセージオブジェクトに対して実行 しましょう!
トラップ2:getBody() を使ってしまい余計なHTMLコードで埋もれる
getBody() を使うと、以下のようにHTMLタグがそのまま取得されます。
<div dir="ltr">道産子アウトドアストアをご利用いただき...<br><b>お支払い合計金額:29,800円</b></div>
【解決策】
本文から文字検索を行ったり、テキストとしてスプレッドシートに入力したい場合は、必ず getPlainBody() を使うようにしましょう!
トラップ3:複数のやり取りがあるスレッドで「昔のメール」を取得してしまう
スレッド内に複数の返信やり取り(メッセージ)が存在する場合、messages[0] を指定すると「一番最初(過去)に届いたメール」が取得されてしまいます。
【解決策】
一番新しいメッセージを取得したい場合は、配列の長さを利用して messages[messages.length - 1] と指定するのが鉄則です。
var messages = thread.getMessages();
// スレッド内の一番最後のメッセージ(最新)を取得
var latestMessage = messages[messages.length - 1];
トラップ4:メールが見つからずに Cannot read properties of undefined エラーが出る
検索条件に一致するメールが1通もない場合、GmailApp.search() は空の配列 [] を返します。
その状態で threads[0].getMessages() を実行しようとすると、undefined(存在しないもの)に対して操作を行おうとしてプログラムがクラッシュします。
【解決策】
実務コードでは、以下のように「検索結果が存在するか」を事前にチェックする安全ガード(IF文)を入れておきましょう。
var threads = GmailApp.search("検索キーワード");
if (threads.length === 0) {
Logger.log("該当するメールがありませんでした。");
return; // 処理を安全に中断
}
7. 今回のまとめと次回予告
今回は、1通のメールから件名や本文をプログラムで取得する GmailMessage.getSubject() と GmailMessage.getBody() / getPlainBody() について解説しました。
今日の重要ポイントおさらい
getSubject()はメールの件名(タイトル)を取得する。getBody()はHTML形式、getPlainBody()は文字だけのプレーンテキスト本文を取得する。- データ抽出やスプレッドシートへの転記には
getPlainBody()が圧倒的におすすめ! - これらの命令は
GmailThreadではなくGmailMessageオブジェクトに対して実行する。 - 文字列操作(
matchやsplit)と組み合わせることで、自動データ入力ツールが完成する!
メールの件名と本文が自由に扱えるようになると、Gmail自動化の可能性が一気に広がりますね!
さて、メールの中身が読めるようになると、次に気になるのは「メールに添付されて届いた画像やPDFファイル(請求書や領収書など)をプログラムで取り出したい!」ということではないでしょうか?
次回(第36回)は、メールの添付ファイルを自動で取得する GmailMessage.getAttachments() を解説します!
届いた「除雪費用の請求書PDF」を自動で取り出してGoogleドライブへ保存する、超実践的な連携テクニックを学んでいきましょう。ぜひお楽しみに!
