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

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

大量のメールを移動してスッキリさせたいですよね？

複数のメッセ―ジやスレッドをまとめて制御して移動することができます。

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

ＧメールAPPクラス[GmailApp]のメッセージ移動
1. メッセージのゴミ箱移動[moveMessageToTrash(メッセージ)]
2. 複数メッセージのゴミ箱移動[moveMessagesToTrash(メッセージ's)]
ＧメールAPPクラス[GmailApp]のスレッド移動
Ｇメールメッセージクラス[GmailMessage]
1. メッセージのゴミ箱移動[moveToTrash()]
Ｇメールスレッドクラス[GmailThread]
最後に

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

Ｇメールのメッセージ移動メソッドです。

メッセージのゴミ箱移動[moveMessageToTrash(メッセージ)]

moveMessageToTrash(message)
メッセージをゴミ箱に移動し、メッセージを強制的に更新します。

function moveMessageToTrashSample() {
  // 受信トレイの最初のメッセージをゴミ箱に移動します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var firstMessage = firstThread.getMessages()[0];
  GmailApp.moveMessageToTrash(firstMessage);
}

Parameters
名前	タイプ	説明
message	GmailMessage	ゴミ箱に入れるメッセージ。

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

複数メッセージのゴミ箱移動[moveMessagesToTrash(メッセージ's)]

moveMessagesToTrash(messages)
指定されたメッセージをゴミ箱に移動し、メッセージを強制的に更新します。

function moveMessagesToTrashSample() {
  // 受信トレイの最初の2つのメッセージをゴミ箱に移動します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var messages = firstThread.getMessages();
  var toDelete = [messages[0], messages[1]];
  GmailApp.moveMessagesToTrash(toDelete);
}

Parameters
名前	タイプ	説明
messages	GmailMessage[]	ゴミ箱に入れるメッセージ。

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

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

Ｇメールのスレッド移動メソッドです。

スレッドのアーカイブ移動[moveThreadToArchive(スレッド)]

moveThreadToArchive(thread)
このスレッドをアーカイブに移動し、スレッドを強制的に更新します。

function moveThreadToArchiveSample() {
  // 受信トレイの最初のスレッドをアーカイブします
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  GmailApp.moveThreadToArchive(firstThread);
}

Parameters
名前	タイプ	説明
thread	GmailThread	アーカイブするスレッド。

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

スレッドの受信ボックス移動[moveThreadToInbox(スレッド)]

moveThreadToInbox(thread)
このスレッドを受信ボックスに移動し、スレッドを強制的に更新します。

function moveThreadToInboxSample() {
  // まだ受信トレイにないスレッドを見つけます
  var thread = GmailApp.search("-in:inbox")[0]; // 最初のものを取得
  GmailApp.moveThreadToInbox(thread);
}

Parameters
名前	タイプ	説明
thread	GmailThread	受信ボックスに移動するスレッド。

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

スレッドのスパム移動[moveThreadToSpam(スレッド)]

moveThreadToSpam(thread)
このスレッドをスパムに移動し、スレッドを強制的に更新します。

function moveThreadToSpamSample() {
  // 受信トレイの最初のスレッドをスパムとしてタグ付けします
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  GmailApp.moveThreadToSpam(firstThread);
}

Parameters
名前	タイプ	説明
thread	GmailThread	スパムに移動するスレッド。

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

スレッドのゴミ箱移動[moveThreadToTrash(スレッド)]

moveThreadToTrash(thread)
このスレッドをゴミ箱に移動し、スレッドを強制的に更新します。

function moveThreadToTrashSample() {
  // 受信トレイの最初のスレッドをゴミ箱に移動します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  GmailApp.moveThreadToTrash(firstThread);
}

Parameters
名前	タイプ	説明
thread	GmailThread	トラッシュされるスレッド。

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

複数スレッドのアーカイブ移動[moveThreadsToArchive(スレッド's)]

moveThreadsToArchive(threads)
これらのスレッドをアーカイブに移動し、スレッドを強制的に更新します。

function moveThreadsToArchiveSample() {
  // 受信ボックスの最初の2つのスレッドをアーカイブに移動します
  var firstTwoThreads = GmailApp.getInboxThreads(0,2);
  GmailApp.moveThreadsToArchive(firstTwoThreads);
}

Parameters
名前	タイプ	説明
threads	GmailThread[]	アーカイブされるスレッドの配列。

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

複数スレッドの受信ボックス移動[moveThreadsToInbox(スレッド's)]

moveThreadsToInbox(threads)
これらのスレッドを受信ボックスに移動し、スレッドを強制的に更新します。

function moveThreadsToInboxSample() {
  // まだ受信トレイにない2つのスレッドを見つけます
  var firstTwoThreads = GmailApp.search("-in:inbox", 0, 2);
  GmailApp.moveThreadsToInbox(firstTwoThreads);
}

Parameters
名前	タイプ	説明
threads	GmailThread[]	受信ボックスに移動するスレッドの配列。

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

複数スレッドのスパム移動[moveThreadsToSpam(スレッド's)]

moveThreadsToSpam(threads)
これらのスレッドをスパムに移動し、スレッドを強制的に更新します。

function moveThreadsToSpamSample() {
  // 受信トレイの最初の2つのスレッドをスパムに移動します
  var firstTwoThreads = GmailApp.getInboxThreads(0,2);
  GmailApp.moveThreadsToSpam(firstTwoThreads);
}

Parameters
名前	タイプ	説明
threads	GmailThread[]	スパムに移動するスレッドの配列。

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

複数スレッドのゴミ箱移動[moveThreadsToTrash(スレッド's)]

moveThreadsToTrash(threads)
これらのスレッドをゴミ箱に移動し、スレッドを強制的に更新します。

function moveThreadsToTrashSample() {
  // 受信トレイの最初の2つのスレッドをゴミ箱に移動します
  var firstTwoThreads = GmailApp.getInboxThreads(0,2);
  GmailApp.moveThreadsToTrash(firstTwoThreads);
}

Parameters
名前	タイプ	説明
threads	GmailThread[]	トラッシュされるスレッドの配列。

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

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

Ｇメールのメッセージ移動メソッドです。

メッセージのゴミ箱移動[moveToTrash()]

moveToTrash()
メッセージをゴミ箱に移動します。

function moveToTrashSample() {
  var thread = GmailApp.getInboxThreads(0,1)[0]; // 受信トレイで最初のスレッドを取得します
  var message = thread.getMessages()[0]; // 最初のメッセージを取得
  message.moveToTrash(); // メッセージをゴミ箱に移動します
}

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

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

Ｇメールのスレッド移動メソッドです。

スレッドのアーカイブ移動[moveToArchive()]

moveToArchive()
このスレッドをアーカイブに移動します。

function moveToArchiveSample() {
  // 最初の受信トレイスレッドをアーカイブします
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.moveToArchive();
}

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

スレッドの受信ボックス移動[moveToInbox()]

moveToInbox()
このスレッドを受信ボックスに移動します。

function moveToInboxSample() {
  // 最初の非受信スレッドを受信ボックスに移動します
  var firstThread = GmailApp.search("-in:inbox")[0];
  firstThread.moveToInbox();
}

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

スレッドのスパム移動[moveToSpam()]

moveToSpam()
このスレッドをスパムに移動します。

function moveToSpamSample() {
  // 最初の受信トレイスレッドをスパムに移動します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.moveToSpam();
}

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

スレッドのゴミ箱移動[moveToTrash()]

moveToTrash()
このスレッドをゴミ箱に移動します。

function moveToTrashSample() {
  // 最初の受信トレイのスレッドをゴミ箱に移動します
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  firstThread.moveToTrash();
}

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

最後に

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

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

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

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

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

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

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

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

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

Googleスプレッドシートの使い方や機能がわかるショートカットキー全まとめ一覧【初心者こそ必見】

表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン...

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