MENU
日々の学習にAIを取り入れて！がこのブログのメインテーマです。編集は人力で行っています。
  1. ホーム
  2. GASもろもろ
  3. 【Gmailメッセージのプレーンテキスト取得】使い方・具体例・サンプルコードで簡単に理解しよう！

【Gmailメッセージのプレーンテキスト取得】使い方・具体例・サンプルコードで簡単に理解しよう！

GASもろもろ

※関数の書き方・実行結果に誤りがあるケースがあります。随時修正中です。また誤りに気づかれた方はこちらからご連絡頂きますとめちゃ嬉しいです。

目次

getPlainBody メソッドの基本

おおきに！今日はGmailのメッセージから、プレーンテキストのボディを取得する「getPlainBody」メソッドについて教えるで！

このメソッドは、GmailMessageクラスに属していて、メールの本文をプレーンテキストとして取得するために使うんや。HTML形式でメールが送られてきたとしても、このメソッドを使うと、余計なタグとかが取り除かれた状態で、シンプルなテキストが返ってくるんや。

メソッドの構文

GmailMessage.getPlainBody()

パラメータ

「getPlainBody」メソッドには、特に必要なパラメータはないんや。このメソッドを呼び出すだけで、そのメールのプレーンテキストが返ってくるから、簡単やな！

使い方のサンプルコード

さあ、実際に使ってみるで！以下のサンプルコードを見てな。

function getEmailBody() {
  const threads = GmailApp.getInboxThreads(0, 1); // 受信トレイの一番上のスレッドを取得
  const message = threads[0].getMessages()[0]; // スレッドの最初のメッセージを取得
  const plainBody = message.getPlainBody(); // プレーンテキストの本文を取得

  Logger.log(plainBody); // コンソールに出力する
}

このコードは、受信トレイの一番上のメールのプレーンテキストを取得して、コンソールに出力するもんや。まずはスレッドを取得して、その中のメッセージを取り出し、最後に「getPlainBody」を使うてプレーンボディを取得する流れやで。

これで、Gmailのメッセージから簡単にプレーンテキストを取得できるようになるんや！どんどん試してみてな！

コードのサンプル事例

おおきに！今度は「getPlainBody」メソッドの具体的なコードのサンプルを見ていくで。単純な使用例から、ちょっと複雑な例、さらには他のメソッドとの組み合わせなんかも紹介するわ！

単純な使用例

まずは、さっきのサンプルを少しだけシンプルにしてみるわ。受信トレイの一番上のメールのプレーンテキストを取得するだけのコードやで。

function simpleGetEmailBody() {
  const message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0]; // 一番上のメッセージを取得
  const plainBody = message.getPlainBody(); // プレーンテキストの本文を取得

  Logger.log(plainBody); // コンソールに出力する
}

これだけで、受信トレイの一番上のメールの本文をプレーンテキストで取得できるんや。簡単やな！

より複雑な使用例

次は、複数のメールをループで処理して、各メールのプレーンテキストを取得する例を見てみよう。

function complexGetEmailBodies() {
  const threads = GmailApp.getInboxThreads(0, 5); // 受信トレイの上から5つのスレッドを取得
  let allPlainBodies = []; // プレーンテキストを格納する配列を初期化

  for (const thread of threads) {
    const messages = thread.getMessages(); // スレッド内のメッセージを取得
    for (const message of messages) {
      const plainBody = message.getPlainBody(); // プレーンテキストの本文を取得
      allPlainBodies.push(plainBody); // 配列に追加
    }
  }

  Logger.log(allPlainBodies); // すべてのプレーンテキストをコンソールに出力
}

このコードでは、受信トレイの最初の5つのスレッドを取得して、その中のすべてのメッセージのプレーンテキストを配列に格納してるんや。これで、複数のメールの内容を一度に取得できるで！

他のメソッドと組み合わせた活用例

最後に、「getPlainBody」メソッドを他のメソッドと組み合わせて、特定のキーワードを含むメールを表示する例を紹介するで。

function keywordSearchInEmailBodies(keyword) {
  const threads = GmailApp.search(`"${keyword}"`); // キーワードを含むメールを検索
  let foundEmails = []; // 検索結果を格納する配列を初期化

  for (const thread of threads) {
    const messages = thread.getMessages(); // スレッド内のメッセージを取得
    for (const message of messages) {
      const plainBody = message.getPlainBody(); // プレーンテキストの本文を取得
      if (plainBody.includes(keyword)) { // キーワードが含まれているかチェック
        foundEmails.push(plainBody); // 含まれていたら配列に追加
      }
    }
  }

  Logger.log(foundEmails); // キーワードを含むメールのプレーンテキストをコンソールに出力
}

このコードでは、指定したキーワードを含むメールを検索して、そのメールのプレーンテキストを取得してるんや。これで、自分が探してるメールの内容を簡単にチェックできるで！

こうやって、「getPlainBody」メソッドを色々な形で活用できるから、使ってみてな！どんな応用ができるか、考えてみるのも面白いで！

getPlainBody の実際の使用シナリオ

おおきに！次は「getPlainBody」メソッドが実際にどんな場面で役立つか、具体的な業務や個人利用のシーンを紹介するで。これを知ると、GASを使う楽しさがもっと増えるはずや！

業務利用のシーン

1. フィードバック収集

例えば、会社でお客さんからのフィードバックをまとめたいとするやんか。お客さんが送ってくれたメールの内容をプレーンテキストで取得して、分析用のスプレッドシートに書き込むことができるんや。

function collectFeedback() {
  const threads = GmailApp.search('フィードバック'); // フィードバック関連のメールを検索
  const feedbacks = [];

  for (const thread of threads) {
    const messages = thread.getMessages();
    for (const message of messages) {
      const plainBody = message.getPlainBody();
      feedbacks.push(plainBody);
    }
  }

  // ここでスプレッドシートにフィードバックを追加する処理を書くことができるで
  Logger.log(feedbacks);
}

このコードを使えば、フィードバックを簡単に集められて、業務改善に役立てることができるんや。

2. 自動応答システム

また、特定のキーワードに基づいて自動で返信するシステムなんかも考えられるで。受信したメールの内容をチェックして、特定の用件に対して自動で返事をするということができるんや。

function autoReply() {
  const threads = GmailApp.getInboxThreads(0, 10); // 受信トレイの上から10件のスレッドを取得

  for (const thread of threads) {
    const message = thread.getMessages()[0];
    const plainBody = message.getPlainBody();

    if (plainBody.includes('サポート')) {
      // サポートに関するメールには自動で返信
      thread.reply('ご連絡ありがとうございます。サポートチームが対応いたします。');
    }
  }
}

これで、忙しい業務の中でも適切にお客様に返事を返すことができるようになるで。

個人利用のシーン

1. 学習メモの整理

個人で学習している内容をメールで送信している場合、後からその内容を整理したいときもあるやろ。学んだことをメールで送っておいて、後で「getPlainBody」を使って整理することができるんや。

function organizeLearningNotes() {
  const threads = GmailApp.search('学習メモ'); // 学習メモに関するメールを検索
  const notes = [];

  for (const thread of threads) {
    const messages = thread.getMessages();
    for (const message of messages) {
      const plainBody = message.getPlainBody();
      notes.push(plainBody);
    }
  }

  Logger.log(notes); // 学習メモをコンソールに出力
}

このように、後から振り返って学習内容をまとめたり、整理するのに役立つで。

2. 旅行の計画

旅行の計画をメールでやりとりしている場合、旅行先の情報や宿泊先の情報をプレーンテキストでまとめておくと便利や。これを使って、旅行計画を一つにまとめることができるで。

function gatherTravelPlans() {
  const threads = GmailApp.search('旅行計画'); // 旅行計画に関するメールを検索
  const plans = [];

  for (const thread of threads) {
    const messages = thread.getMessages();
    for (const message of messages) {
      const plainBody = message.getPlainBody();
      plans.push(plainBody);
    }
  }

  Logger.log(plans); // 旅行計画をコンソールに出力
}

こうすることで、旅行の準備もスムーズに進むし、楽しい思い出が増えるで！

実際のプロジェクトでの応用例

例えば、企業の顧客サポートシステムに組み込むことで、顧客からの問い合わせメールを自動で処理し、内容を更新するシステムを作ることができるで。プレーンテキストの取得を利用して、顧客の要望や苦情を分析し、その結果をダッシュボードに表示するというプロジェクトなんかも考えられるな。

このように、「getPlainBody」メソッドは、業務や個人利用のさまざまなシーンで役立つから、ぜひ活用してみてな！

getPlainBody を例えるなら

おおきに！今度は「getPlainBody」メソッドを日常生活の何かに例えて、もっとわかりやすく説明するで。

例え：メールのラッピングを剥がす

「getPlainBody」を使うことを、まるでプレゼントのラッピングを剥がす作業に例えられるで。考えてみてな。

  1. メールの内容が「プレゼント」や。
  2. メールがHTML形式で送られてくると、ラッピング（色とりどりのデザインや装飾）が施されてる状態やな。
  3. 「getPlainBody」を使うことで、そのラッピングを剥がして、中身（プレーンテキスト）だけを取り出すことができるんや。

つまり、このメソッドは、見た目の派手さを取り払って、メールの本質的な内容だけを取り出すための道具なんや。ラッピングが無ければ、内容がすぐにわかるように、プレーンテキストにすることで、情報をシンプルに理解できるようになるんやで。

具体的なイメージ

たとえば、友達から誕生日プレゼントをもらったとするやんか。ラッピングはかわいいけど、欲しいのは中身やん？「getPlainBody」を使ったら、そのラッピングを剥がして、中身のプレゼントだけを手に入れるみたいに、メールの内容だけを簡単に取得できるわけや。

こうやって考えると、「getPlainBody」がどんな役割を果たしているのか、もっと直感的に理解できるやろ？メールの中身をシンプルに、わかりやすく取り出すための大事なメソッドなんや。ぜひこのイメージを持って、GASを使ってみてな！

getPlainBody の便利なシーンでの事例

おおきに！ここでは「getPlainBody」メソッドがどんな具体的なシーンで便利に使えるか、ビジネスや学業での実用的なケーススタディを紹介するで。これを知ると、タイムセーブや効率向上に役立つこと間違いなしや！

ビジネスでの実用的なケーススタディ

1. 顧客からの問い合わせ管理

企業が顧客からの問い合わせを管理するために、「getPlainBody」を使うて、メールの内容を簡単に取り出して、データベースに登録することができるんや。たとえば、サポートチームが多くの問い合わせを受けている場合、メールの本文をプレーンテキストで取得して、その内容をスプレッドシートやCRMシステムに自動で記録することができるで。

function logCustomerInquiries() {
  const threads = GmailApp.search('顧客問い合わせ'); // 顧客からの問い合わせメールを検索
  const inquiries = [];

  for (const thread of threads) {
    const messages = thread.getMessages();
    for (const message of messages) {
      const plainBody = message.getPlainBody(); // 本文をプレーンテキストで取得
      inquiries.push(plainBody); // 配列に追加
    }
  }

  // ここでスプレッドシートに問い合わせ内容を追加する処理を行うことができるで
  Logger.log(inquiries);
}

この方法を使うことで、手動でメールを確認する手間が省けて、サポート業務の効率がめっちゃ向上するんや。

2. 定期的なレポート作成

ビジネスでは、定期的にメールからデータを抽出してレポートを作成することもあるやろ。たとえば、営業チームの進捗状況をまとめたメールを受け取ったら、その内容を「getPlainBody」で取り出して、レポート用のスプレッドシートに自動で記録することができるで。

function generateSalesReport() {
  const threads = GmailApp.search('営業進捗'); // 営業進捗に関するメールを検索
  const reportData = [];

  for (const thread of threads) {
    const messages = thread.getMessages();
    for (const message of messages) {
      const plainBody = message.getPlainBody(); // 本文をプレーンテキストで取得
      reportData.push(plainBody); // レポートデータに追加
    }
  }

  // レポートを作成するための処理をここに書くことができるで
  Logger.log(reportData);
}

これで、毎回手動でメールを確認する必要がなくなり、効率的にレポートを作成できるようになるんや。

学業での実用的なケーススタディ

1. 課題提出の整理

学生が教授やクラスメイトから送られてくる課題に関するメールを整理する際にも、「getPlainBody」が役立つで。例えば、受け取った課題の内容をプレーンテキストで取得して、タスクリストやカレンダーに自動で登録することができるんや。

function organizeAssignments() {
  const threads = GmailApp.search('課題'); // 課題に関するメールを検索
  const assignments = [];

  for (const thread of threads) {
    const messages = thread.getMessages();
    for (const message of messages) {
      const plainBody = message.getPlainBody(); // 本文をプレーンテキストで取得
      assignments.push(plainBody); // 課題リストに追加
    }
  }

  Logger.log(assignments); // 課題をコンソールに出力
}

これを使うことで、課題の内容を整理する手間が省けて、学業の効率がアップするやろ。

2. 学習メモの収集

また、学習した内容をメールでまとめている場合、その内容を「getPlainBody」を使ってプレーンテキストとして取り出し、後で振り返るための資料を作成することができるで。

function collectStudyNotes() {
  const threads = GmailApp.search('学習メモ'); // 学習メモに関するメールを検索
  const notes = [];

  for (const thread of threads) {
    const messages = thread.getMessages();
    for (const message of messages) {
      const plainBody = message.getPlainBody(); // 本文をプレーンテキストで取得
      notes.push(plainBody); // 学習メモに追加
    }
  }

  Logger.log(notes); // 学習メモをコンソールに出力
}

これで、学習内容をまとめる作業がスムーズになり、後から見返すのも簡単になるで。

タイムセーブや効率向上の具体的な例

「getPlainBody」を使うことで、メールの内容を手動で確認したり、コピー＆ペーストする手間が省けるから、時間の節約につながるんや。特に、定期的に多くのメールを処理する必要がある業務や学業において、このメソッドを活用することで、効率的に情報を整理できるようになるで。

こうやって、「getPlainBody」メソッドが具体的にどんな場面で役立つかを考えると、活用の幅が広がるし、実際に試してみたくなるやろ？ぜひ、色々なシーンで使ってみてな！

getPlainBody の注意点とベストプラクティス

おおきに！ここでは「getPlainBody」メソッドを使用する際の注意点やベストプラクティスについて説明するで。これを知っておくと、効率的で安全にメソッドを活用できるようになるから、しっかりチェックしてな！

使用する際の制限事項や注意点

  1. HTMLメールの処理:

  2. 「getPlainBody」は、メールがHTML形式の場合でも正しくプレーンテキストを取得できるけど、元のメールのフォーマットやスタイルは失われるから、特定のフォーマットが必要な場合は注意が必要や。

  3. メールサイズの制限:

  4. Gmailには1通のメールあたりのサイズ制限があるから、大きなメール（特に添付ファイルが多い場合など）では、プレーンテキストが期待通りに取得できない可能性があるで。

  5. メッセージ数の制限:

  6. getMessages()で取得できるメッセージの数に制限があるので、非常に古いメールや大量のスレッドに対して使用すると、取得できるメッセージが限られることがあるから注意が必要や。

効率的で安全な使用方法のアドバイス

  1. 条件付き検索を活用する:

  2. メールを検索する際は、特定のキーワードや期間で絞り込むことで、必要なメールだけを対象にできるから、処理の効率が上がるで。例えば、GmailApp.search('from:example@example.com after:2023/01/01')のように検索条件を使うてな。

  3. エラーハンドリングを実装する:

  4. メールの取得時にエラーが発生する可能性があるから、try-catch構文を使ってエラーハンドリングを行うと、安全に処理できるで。
function safeGetEmailBody() {
  try {
    const threads = GmailApp.getInboxThreads(0, 1);
    const message = threads[0].getMessages()[0];
    const plainBody = message.getPlainBody();
    Logger.log(plainBody);
  } catch (e) {
    Logger.log('エラーが発生しました: ' + e.message);
  }
}
  1. ログを活用する:
  2. 処理の結果をLogger.logで記録しておくと、後から確認できるから便利や。特に大量のメールを処理する場合は、どのメールがどうなったかを把握するのに役立つで。

よくあるエラーとその解決方法

  1. エラー: スレッドが見つからない:

  2. スレッドが見つからない場合、特定の条件で検索しているか確認しなあかん。条件を見直して、適切なメールが取得できるかチェックすることが大事や。

  3. エラー: メッセージが存在しない:

  4. スレッドはあっても、メッセージが存在しない場合は、スレッドにメッセージが含まれているか確認すること。getMessages()の前に、thread.hasMessages()を使って確認することができるで。

  5. エラー: プレーンボディが空:

  6. メールの本文が空の場合、HTMLメールで内容が含まれていないことがあるから、事前にチェックしておくと安心や。getBody()メソッドを使って、内容があるかどうかを確認するのも良い方法や。

これらの注意点とベストプラクティスを守ることで、「getPlainBody」メソッドを安全に、効率的に活用できるようになるで。どんどん試してみて、GASの楽しさを実感してな！

【Gmailメッセージのプレーンテキスト取得】使い方・具体例・サンプルコードで簡単に理解しよう！

GASもろもろ
よかったらシェアしてね！
  • URLをコピーしました！
  • URLをコピーしました！

この記事を書いた人

mjflashのアバター mjflash

関連記事

目次