Gmailのスター付きメールからTodoistのタスクを作成＆Slackに通知する その1 – isStarred()メソッドを使って、未処理のスター付きメールのみを絞り込む

/**
 * class GmailSearch
 * Gmailで検索条件を指定してマッチするメッセージを取得・操作するクラス
 * 
 * プロパティ
 * query - 検索条件
 * threads - 検索結果の各スレッドを格納した配列
 * threadMessages - 検索結果の各メッセージをスレッドごとに二次元配列に格納した配列
 * allMessages - 検索結果の全メールを一次元配列に格納した配列
 * lastThreadMessages - 検索結果の最新のスレッドの各メールを一次元配列に格納した配列
 * firstMessages - 検索結果の各スレッドの最初のメールを一次元配列に格納した配列
 * 
 */

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = */

class GmailSearch {

  /**
   * 検索条件から条件にマッチするメッセージを取得するコンストラクタ
   * @constructor
   * @param {string}  query - 検索条件
   */

  constructor(query) {
    this.query = query;
    this.threads = GmailApp.search(this.query);
    this.threadMessages = GmailApp.getMessagesForThreads(this.threads);
    this.allMessages = this.threadMessages.flat();
    this.lastThreadMessages = this.threadMessages[0];
    this.firstMessages = this.threadMessages.map(thread => thread[0]);
  }
}

function findStarredMails() {
  const query = 'is:starred  newer_than:30d '; // TEST:30日以内に受信したスター付きのメール

  // 検索演算子の条件に該当するメールが含まれるスレッドのすべてのメールを取得
  const aryAllMessages = new GmailSearch(query).allMessages;
  aryAllMessages.forEach(message => console.log(message.getDate(), message.getSubject(), message.getFrom())); // スター付きでないものも含まれる

  // isStarred()メソッドでスター付きのメールのみに絞り込み
  const aryStarredMessages = aryAllMessages.filter(message => message.isStarred());
  aryStarredMessages.forEach(message => console.log(message.getDate(), message.getSubject(), message.getFrom()));

}

function findNewStarredMails() {

  // Gmailの検索演算子：1日以内に受信したスター付きのメール
  const query = 'is:starred  newer_than:1d ';
  
  // 検索演算子の条件に該当するメールが含まれるスレッドのすべてのメールを取得
  const aryAllMessages = new GmailSearch(query).allMessages;
  
  // 取得すべきメッセージがなければ処理を中止
  if (aryAllMessages.length === 0) { return };

  // isStarred()メソッドでスター付きのメールのみに絞り込み
  const aryStarredMessages = aryAllMessages.filter(message => message.isStarred());

  // プロパティストアからメール絞り込みの起算日時を取得
  const dateLastMail = new Date(PropertiesService.getScriptProperties().getProperty('LAST_DATE'));
  
  // 起算日時以降のメールのみに絞り込み
  const aryNewMessage = aryStarredMessages.filter(message => message.getDate() > dateLastMail);

  // 取得すべきメッセージがなければ処理を中止
  if (aryNewMessage.length === 0) { return };

  // GmailMessageクラスのメソッドを利用してメールから必要な情報を取得してTodoistとSlackに通知
  aryNewMessage.forEach(messageNew => console.log(messageNew.getFrom() + '|このログ出力部分にチャットツールに通知する処理を書く'));

  // 起算日時以降のメールを日付で降順に並び替え
  aryNewMessage.sort((a, b) => b.getDate() - a.getDate());

  // 最新のメールから受信日時を取得してプロパティストアに次回の起算日時として保存
  const messageLast = aryNewMessage[0];
  const dateLast = messageLast.getDate();
  PropertiesService.getScriptProperties().setProperty('LAST_DATE', dateLast);

}