【GAS】Ｇメールのマーク機能まとめ【サンプルソース付】

快速ワーク
2019.11.30
スポンサーリンク

GAS開発者向けにＧメールのマーク機能をすべてまとめました。

大量のメールを扱う場合、取捨選択して整理するのは必須です。

見る必要がないので既読マーク、もう一度見るべきだから未読マーク、これは重要だから重要マークなど、いろいろ切り分けましょう。

マークに関するメソッドをすべて載せてます。少しでも参考になれば幸いです。

スポンサーリンク

ＧメールAPPクラス[GmailApp]のメッセージマーク

Ｇメールメッセージのマークメソッドです。

メッセージの既読マーク[markMessageRead(メッセージ)]

markMessageRead(message)
このメッセージに既読のマークを付け、メッセージを強制的に更新します。

function markMessageReadSample() {
  // 受信トレイの最初のスレッドの最初のメッセージを既読にします
  var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
  GmailApp.markMessageRead(message);
}
Parameters
名前タイプ説明
messageGmailMessage既読としてマークするメッセージ。

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markMessageRead(message)

メッセージの未読マーク[markMessageUnread(メッセージ)]

markMessageUnread(message)
Marks this message unread and forces the message to refresh.

function markMessageUnreadSample() {
  // 受信トレイの最初のスレッドの最初のメッセージを未読としてマークします
  var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
  GmailApp.markMessageUnread(message);
}
Parameters
名前タイプ説明
messageGmailMessage未読としてマークするメッセージ。

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markMessageUnread(message)

複数メッセージの既読マーク[markMessagesRead(メッセージ's)]

markMessagesRead(messages)
これらのメッセージに既読のマークを付け、メッセージを強制的に更新します。

function markMessagesReadSample() {
  // 最初の受信トレイスレッドの最初の3つのメッセージを既読としてマークします。
  // 最初の受信トレイスレッドに3つのメッセージがあると仮定します。
  var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
  var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
  GmailApp.markMessagesRead(thread.getMessages());
}
Parameters
名前タイプ説明
messagesGmailMessage[]既読としてマークするメッセージの配列。

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markMessagesRead(messages)

複数メッセージの未読マーク[markMessagesUnread(メッセージ's)]

markMessagesUnread(messages)
これらのメッセージを未読としてマークし、メッセージを強制的に更新します。

function markMessagesUnreadSample() {
  // 最初の受信トレイスレッドの最初の3つのメッセージを未読としてマークします。
  // 最初の受信トレイスレッドに3つのメッセージがあると仮定します
  var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
  var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
  GmailApp.markMessagesUnread(thread.getMessages());
}
Parameters
名前タイプ説明
messagesGmailMessage[]未読としてマークするメッセージの配列。

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markMessagesUnread(messages)

ＧメールAPPクラス[GmailApp]のスレッドマーク

Ｇメールスレッドのマークメソッドです。

スレッドの重要マーク[markThreadImportant(スレッド)]

markThreadImportant(thread)
このスレッドを重要としてマークし、スレッドを強制的に更新します。

function markThreadImportantSample() {
  // 最初の受信トレイスレッドを重要としてマークします
  var thread = GmailApp.getInboxThreads(0, 1)[0];
  GmailApp.markThreadImportant(thread);
}
Parameters
名前タイプ説明
threadGmailThread重要としてマークするスレッド。

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadImportant(thread)

スレッドの既読マーク[markThreadRead(スレッド)]

markThreadRead(thread)
このスレッドを読み取り済みとしてマークし、スレッドを強制的に更新します。

function markThreadReadSample() {
  // 最初の受信トレイスレッドを既読としてマークします
  var thread = GmailApp.getInboxThreads(0, 1)[0];
  GmailApp.markThreadRead(thread);
}
Parameters
名前タイプ説明
threadGmailThread既読としてマークするスレッド。

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadRead(thread)

スレッドの重要ではないマーク[markThreadUnimportant(スレッド)]

markThreadUnimportant(thread)
このスレッドを重要でないものとしてマークし、スレッドを強制的に更新します。

function markThreadUnimportantSample() {
  // 最初の受信トレイスレッドを重要でないものとしてマークします
  var thread = GmailApp.getInboxThreads(0, 1)[0];
  GmailApp.markThreadUnimportant(thread);
}
Parameters
名前タイプ説明
threadGmailThread重要でないとマークするスレッド。

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadUnimportant(thread)

スレッドの未読マーク[markThreadUnread(スレッド)]

markThreadUnread(thread)
このスレッドを未読としてマークし、スレッドを強制的に更新します。

function markThreadUnreadSample() {
  // 最初の受信トレイスレッドを未読としてマークします
  var thread = GmailApp.getInboxThreads(0, 1)[0];
  GmailApp.markThreadUnread(thread);
}
Parameters
名前タイプ説明
threadGmailThread未読としてマークするスレッド。

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadUnread(thread)

複数スレッドの重要マーク[markThreadsImportant(スレッド's)]

markThreadsImportant(threads)
これらのスレッドを重要としてマークし、スレッドを強制的に更新します。

function markThreadsImportantSample() {
  // 受信トレイの最初の2つのスレッドを重要としてマークします
  var threads = GmailApp.getInboxThreads(0, 2);
  GmailApp.markThreadsImportant(threads);
}
Parameters
名前タイプ説明
threadsGmailThread[]重要としてマークするスレッドの配列。

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadsImportant(threads)

複数スレッドの既読マーク[markThreadsRead(スレッド's)]

markThreadsRead(threads)
これらのスレッドを読み取り済みとしてマークし、スレッドを強制的に更新します。

function markThreadsReadSample() {
  // 受信ボックス内の最初の2つのスレッドを既読としてマークします
  var threads = GmailApp.getInboxThreads(0, 2);
  GmailApp.markThreadsRead(threads);
}
Parameters
名前タイプ説明
threadsGmailThread[]既読としてマークするスレッドの配列。

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadsRead(threads)

複数スレッドの重要ではないマーク[markThreadsUnimportant(スレッド's)]

markThreadsUnimportant(threads)
これらのスレッドを重要でないものとしてマークし、スレッドを強制的に更新します。

function markThreadsUnimportantSample() {
  // 受信トレイの最初の2つのスレッドを重要でないものとしてマークします
  var threads = GmailApp.getInboxThreads(0, 2);
  GmailApp.markThreadsUnimportant(threads);
}
Parameters
名前タイプ説明
threadsGmailThread[]重要でないとマークするスレッドの配列。

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadsUnimportant(threads)

複数スレッドの未読マーク[markThreadsUnread(スレッド's)]

markThreadsUnread(threads)
これらのスレッドを未読としてマークし、スレッドを強制的に更新します。

function markThreadsUnreadSample() {
  // 受信トレイの最初の2つのスレッドを未読としてマークします
  var threads = GmailApp.getInboxThreads(0, 2);
  GmailApp.markThreadsUnread(threads);
}
Parameters
名前タイプ説明
threadsGmailThread[]未読としてマークするスレッドの配列。

Return
GmailApp - 連鎖用のGmailサービス。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailApp | Methods | markThreadsUnread(threads)



Ｇメールメッセージクラス[GmailMessage]

Ｇメールメッセージのマークメソッドです。

メッセージの既読マーク[markRead()]

markRead()
メッセージに既読のマークを付けます。

function markReadSample() {
  var thread = GmailApp.getInboxThreads(0,1)[0]; // 受信トレイで最初のスレッドを取得します
  var message = thread.getMessages()[0]; // 最初のメッセージを取得
  message.markRead(); // 既読にする
}

Return
GmailMessage - 連鎖用のGmailメッセージ。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | markRead()

メッセージの未読マーク[markUnread()]

markUnread()
メッセージを未読としてマークします。

function markUnreadSample() {
  var thread = GmailApp.getInboxThreads(0,1)[0]; // 受信トレイで最初のスレッドを取得します
  var message = thread.getMessages()[0]; // 最初のメッセージを取得
  message.markUnread(); // 未読としてマーク
}

Return
GmailMessage - 連鎖用のGmailメッセージ。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailMessage | Methods | markUnread()

Ｇメールスレッドクラス[GmailThread]

Ｇメールスレッドのマークメソッドです。

スレッドの重要マーク[markImportant()]

markImportant()
このスレッドを重要としてマークします。

function markImportantSample() {
  // 最初の受信トレイスレッドを重要としてマークする
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.markImportant();
}

Return
GmailThread - 連鎖用のGmailスレッド。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | markImportant()

スレッドの既読マーク[markRead()]

markRead()
このスレッドを既読としてマークします。

function markReadSample() {
  // 最初の受信トレイスレッドを既読にする
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.markRead();
}

Return
GmailThread - 連鎖用のGmailスレッド。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | markRead()

スレッドの重要ではないマーク[markUnimportant()]

markUnimportant()
このスレッドを重要でないものとしてマークします。

function markUnimportantSample() {
  // 最初の受信トレイスレッドを重要でないものとしてマークする
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.markUnimportant();
}

Return
GmailThread - 連鎖用のGmailスレッド。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | markUnimportant()

スレッドの未読マーク[markUnread()]

markUnread()
このスレッドを未読としてマークします。

function markUnreadSample() {
  // 最初の受信トレイスレッドを未読としてマークします
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.markUnread();
}

Return
GmailThread - 連鎖用のGmailスレッド。

参照：Google Apps Script | REFERENCE | Gmail | Class GmailThread | Methods | markUnread()

最後に

Ｇメールのマーク機能のまとめをご紹介させていただきました.

スプレッドシートと組み合わせるとさらに効果的です。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの使い方や機能がわかるショートカットキー全まとめ一覧【初心者こそ必見】
表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン...
caymezon.com
2019.03.16

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。



快速ワーク
GASGmail
スポンサーリンク
スポンサーリンク
caymezon
快 ブログ
スポンサーリンク

コメント

//▼2023/04/08追加 //https://lovagelab.com/posts/3406/ //▲2023/04/08追加