Class GmailMessage

返信先アドレスを使用して、このメッセージの送信者に返信する下書きメッセージを作成します。メールのサイズ（ヘッダーを含む）は割り当て制限されます。

// Create a draft reply to the original message with an acknowledgment.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReply("Got your message");

パラメータ

戻る

GmailDraft - 新しく作成された下書きメッセージ。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• reply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

オプションの引数を指定して、返信先アドレスを使用して、このメッセージの送信者に返信するメールの下書きを作成します。

メールには、書式なしテキストと HTML 本文の両方を含めることができます。メールのサイズ（ヘッダーを含む）は割り当て制限されます。

// Create a draft response with an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

パラメータ

拡張パラメータ

戻る

GmailDraft - 新しく作成された下書きメッセージ。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• reply(body, options)
• createDraftReply(body)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

返信先アドレスとこのメッセージのすべての受信者を使用して、送信者に返信するメールの下書きを作成します。メールのサイズ（ヘッダーを含む）は割り当て制限されます。

// Create a draft response to all recipients (except those bcc'd) with an acknowledgment.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("Got your message");

パラメータ

戻る

GmailDraft - 新しく作成された下書きメッセージ。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body, options)

返信先アドレスとすべての受信者を使用し、オプションの引数を使用して、このメッセージの送信者に返信するメールの下書きを作成します。

メールには、書式なしテキストと HTML 本文の両方を含めることができます。メールのサイズ（ヘッダーを含む）は割り当て制限されます。

// Create a draft response to all recipients (except those bcc'd) using an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

パラメータ

拡張パラメータ

戻る

GmailDraft - 新しく作成された下書きメッセージ。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• replyAll(body, options)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)

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

// Forward first message of first inbox thread to recipient1 & recipient2, both @example.com
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.forward("recipient1@example.com,recipient2@example.com");

パラメータ

戻る

GmailMessage - このメッセージ。チェーンに役立ちます。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• forward(recipient, options)

省略可能な引数を使用して、このメッセージを新しい受信者に転送します。

メールには、書式なしテキストと HTML 本文の両方を含めることができます。メールのサイズ（ヘッダーを含む）は割り当て制限されます。

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"
});

パラメータ

拡張パラメータ

戻る

GmailMessage - このメッセージ。チェーンに役立ちます。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• forward(recipient)

このメッセージのすべての添付ファイルを取得します。

戻る

GmailAttachment[] - このメッセージの Blob アタッチメントの配列。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

このメッセージのすべての添付ファイルを取得します。

パラメータ

拡張パラメータ

戻る

GmailAttachment[] - このメッセージの Blob アタッチメントの配列。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

このメッセージの bcc' のカンマ区切りの宛先を取得します。

定義上、これはすべての受信メッセージに対して空です。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getBcc()); // Log bcc'd addresses

戻る

String - このメッセージの受信者（カンマ区切り）。受信者は Bcc です。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• getTo()

このメッセージの本文の HTML コンテンツを取得します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getBody()); // Log contents of the body

戻る

String - このメッセージの本文。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• getSubject()

このメッセージの Cc と C をカンマ区切りで取得します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getCc()); // Log cc'd addresses

戻る

String - このメッセージの Cc を指定したカンマ区切りの受信者。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• getTo()

このメッセージの日付と時刻を取得します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getDate()); // Log date and time of the message

戻る

Date - このメッセージの日時。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

このメッセージの送信者を取得します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getFrom()); // Log from address of the message

戻る

String - メッセージ送信者のメールアドレス。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• getReplyTo()

RFC2822 ヘッダーを含む特定のヘッダーの値を取得します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox.
var message = thread.getMessages()[0];         // Get the first message.
Logger.log(message.getHeader("Message-ID"));   // Logs the Message-ID RFC 2822 header.

パラメータ

戻る

String - ヘッダーの値。メッセージにヘッダーが存在しない場合は空の文字列になります。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

このメッセージの ID を取得します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
var id = message.getId();
var messageById = GmailApp.getMessageById(id);
Logger.log(message.getSubject() == messageById.getMessage()); // Always logs true

戻る

String - メッセージ ID。

HTML 形式を使用せずに、このメッセージの本文を取得します。これは getBody() よりも複雑で、時間がかかります。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getPlainBody()); // Log contents of the body

戻る

String - このメッセージの本文のコンテンツ。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• getSubject()

このメッセージの未加工のコンテンツを取得します。Gmail の UI で「元のバージョンを表示」と同じです。

戻る

String - このメッセージの未加工のコンテンツ。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

このメッセージの返信先アドレス（通常は送信者）を取得します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getReplyTo()); // Logs reply-to address

戻る

String - 返信のメールアドレス。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• getCc()

このメッセージの件名を取得します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getSubject()); // Log subject line

戻る

String - このメッセージの件名。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• getAttachments()

このメッセージを含むスレッドを取得します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getThread().getFirstMessageSubject() ==
           thread.getFirstMessageSubject()); // Always logs true

戻る

GmailThread - このメッセージが含まれている GmailThread。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

このメッセージのカンマ区切りの受信者を取得します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getTo()); // Log the recipient of message

戻る

String - このメッセージのカンマ区切りの受信者。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• getCc()

このメッセージが下書きかどうかを取得します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is draft? " + message.isDraft());

戻る

Boolean - このメッセージが下書きかどうか。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

このメッセージがチャットであるかどうかを取得します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is a chat? " + message.isInChats());

戻る

Boolean - このメッセージがチャットかどうかを指定します。

このメッセージが受信トレイにあるかどうかを取得します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in inbox? " + message.isInInbox());

戻る

Boolean - このメッセージが受信トレイにあるかどうか。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

このメッセージが優先受信トレイにある場合は true を返し、それ以外の場合は false を返します。

var thread = GmailApp.getPriorityInboxThreads(0,1)[0]; // Get first thread in priority inbox
var messages = thread.getMessages();
for (var i = 0; i < messages.length; i++) {
  // At least one of the messages is in priority inbox
  Logger.log("is in priority inbox? " + messages[i].isInPriorityInbox());
}

戻る

Boolean - 優先トレイにあるメールかどうか。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

このメッセージがゴミ箱にあるかどうかを取得します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in the trash? " + message.isInTrash());

戻る

Boolean - このメッセージがゴミ箱にあるかどうか。

このメッセージにスターが付いているかどうかを確認します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is starred? " + message.isStarred());

戻る

Boolean - このメッセージにスターが付いているかどうかを示します。

このメッセージが未読かどうかを取得します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is unread? " + message.isUnread());

戻る

Boolean - このメッセージの未読ステータス。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

メッセージを既読にします。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.markRead(); // Mark as read

戻る

GmailMessage - この GmailMessage。チェーンに役立ちます。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• isUnread()

メッセージを未読にします。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.markUnread(); // Mark as unread

戻る

GmailMessage - この GmailMessage。チェーンに役立ちます。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• isUnread()

メールをゴミ箱に移動します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.moveToTrash(); // Move message to trash

戻る

GmailMessage - この GmailMessage。チェーンに役立ちます。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• isInTrash()

このメッセージと、関連する状態を Gmail から再読み込みします（ラベル、読み取り状態などに変更があった場合に便利です）。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
// .. Do bunch of stuff here
message.refresh(); // Make sure it's up to date
// Do more stuff to message

戻る

GmailMessage - チェーンするためのメッセージ。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

このメッセージへの返信先アドレスを使用してこのメッセージの送信者に返信します。メールのサイズ（ヘッダーを含む）は割り当て制限されます。

// Respond to author of message with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.reply("Got your message");

パラメータ

戻る

GmailMessage - このメッセージ。チェーンに役立ちます。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• reply(body, options)
• replyAll(body)
• replyAll(body, options)

このメッセージの返信先アドレスに、任意の引数とともに返信します。

メールには、書式なしテキストと HTML 本文の両方を含めることができます。メールのサイズ（ヘッダーを含む）は割り当て制限されます。

// Respond with HTML body text
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.reply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  noReply: true
});

パラメータ

拡張パラメータ

戻る

GmailMessage - このメッセージ。チェーンに役立ちます。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• reply(body)
• replyAll(body)
• replyAll(body, options)

このメッセージへの返信先アドレスとすべての受信者を使用して、送信者に返信します。メールのサイズ（ヘッダーを含む）は割り当て制限されます。

// Respond to all recipients (except bcc'd) of last email in thread with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.replyAll("Got your message");

パラメータ

戻る

GmailMessage - このメッセージ。チェーンに役立ちます。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• reply(body)
• reply(body, options)
• replyAll(body, options)

返信先アドレスとすべての受信者を使用して、このメッセージの送信者に返信します。オプションで引数を指定できます。

メールには、書式なしテキストと HTML 本文の両方を含めることができます。メールのサイズ（ヘッダーを含む）は割り当て制限されます。

// Respond with HTML body text
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
messageThread.replyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  noReply: true
});

パラメータ

拡張パラメータ

戻る

GmailMessage - このメッセージ。チェーンに役立ちます。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• reply(body)
• reply(body, options)
• replyAll(body)

メールにスターを付けます。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.star(); // Star the message

戻る

GmailMessage - この GmailMessage。チェーンに役立ちます。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• unstar()

メッセージのスターを外します。

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.unstar(); // Unstar the message

戻る

GmailMessage - この GmailMessage。チェーンに役立ちます。

認可

このメソッドを使用するスクリプトには、次のうち 1 つ以上のスコープまたは関連する REST API による適切なスコープによる承認が必要です。

• https://mail.google.com/

関連ドキュメント

• star()