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

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

あらかじめ準備しておいて、簡単に手早く転送できるようにしましょう。

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

Ｇメールメッセージクラス[GmailMessage]の転送
1. 転送１[forward(受信者)]
2. 転送２[forward(受信者, オプション)]
最後に

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

Ｇメールの転送メソッドです。

転送１[forward(受信者)]

forward(recipient)
このメッセージを新しい受信者に転送します。メールのサイズ（ヘッダーを含む）は制限されています。

function forward1Sample() {
  // 最初の受信トレイスレッドの最初のメッセージを受信者1と受信者2に転送します。両方とも@ example.com
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var message = firstThread.getMessages()[0];
  message.forward("recipient1@example.com,recipient2@example.com");
}

Parameters
名前	タイプ	説明
recipient	String	電子メールアドレスのコンマ区切りリスト。

Return
GmailMessage - 連携用のメッセージ

転送２[forward(受信者, オプション)]

forward(recipient, options)
オプションの引数を使用して、このメッセージを新しい受信者に転送します。

電子メールには、プレーンテキストとHTML本文の両方を含めることができます。メールのサイズ（ヘッダーを含む）は制限されています。

function forward2Sample() {
  var firstThread = GmailApp.getInboxThreads(0,1)[0];
  var message = firstThread.getMessages()[0];
  message.forward("recipient1@example.com,recipient2@example.com", {
    cc: "myboss@example.com",
    bcc: "mybosses-boss@example.com,vp@example.com"
  });
}

Parameters
名前	タイプ	説明
recipient	String	電子メールアドレスのコンマ区切りリスト。
options	Object	以下にリストされているように、拡張パラメーターを指定するJavaScriptオブジェクト。

Advanced parameters
名前	タイプ	説明
attachments	BlobSource[]	電子メールで送信するファイルの配列
bcc	String	BCCへの電子メールアドレスのコンマ区切りリスト
cc	String	CCへの電子メールアドレスのコンマ区切りリスト
from	String	電子メールの送信元アドレス。GmailApp.getAliases（）によって返される値のいずれかである必要があります
htmlBody	String	設定すると、HTMLをレンダリングできるデバイスは、必要なbody引数の代わりにHTMLを使用します。メールにインライン画像がある場合は、HTML本文にオプションのinlineImagesフィールドを追加できます
inlineImages	Object	画像キー（String）から画像データ（BlobSource）へのマッピングを含むJavaScriptオブジェクト。これは、htmlBodyパラメーターが使用され、これらの画像への参照がの形式で含まれていることを前提としています
name	String	電子メールの送信者の名前（デフォルト：ユーザーの名前）
noReply	Boolean	受信者が電子メールに返信するのを阻止するために、一般的な返信なしの電子メールアドレスから電子メールを送信する必要がある場合はtrue。このオプションは、G Suiteアカウントでのみ使用でき、Gmailユーザーでは使用できません
replyTo	String	デフォルトの返信先アドレスとして使用するメールアドレス（デフォルト：ユーザーのメールアドレス）
subject	String	電子メールの新しい件名