Class GmailMessage

GmailMessage

ユーザーの Gmail アカウントに届いたメッセージです。

Methods

方法戻り値の型概要
createDraftReply(body)GmailDraft返信先アドレスを使用して、このメッセージの送信者に返信する下書きメッセージを作成します。
createDraftReply(body, options)GmailDraftオプションの引数を指定して、返信先アドレスを使用して、このメッセージの送信者に返信するメールの下書きを作成します。
createDraftReplyAll(body)GmailDraft返信先アドレスとこのメッセージのすべての受信者を使用して、送信者に返信するメールの下書きを作成します。
createDraftReplyAll(body, options)GmailDraftメッセージの送信者に返信する下書きメッセージを作成します。このメッセージは、返信先アドレスとすべての受信者を使用し、省略可能な引数を指定します。
forward(recipient)GmailMessageこのメッセージを新しい受信者に転送します。
forward(recipient, options)GmailMessage省略可能な引数を使用して、このメッセージを新しい受信者に転送します。
getAttachments()GmailAttachment[]このメッセージのすべての添付ファイルを取得します。
getAttachments(options)GmailAttachment[]このメッセージのすべての添付ファイルを取得します。
getBcc()Stringこのメッセージの受信者(カンマ区切り)を bcc' で取得します。
getBody()Stringこのメッセージの本文の HTML コンテンツを取得します。
getCc()Stringこのメッセージの Cc と C をカンマ区切りで取得します。
getDate()Dateこのメッセージの日付と時刻を取得します。
getFrom()Stringこのメッセージの送信者を取得します。
getHeader(name)String指定されたヘッダー名で RFC 2822 ヘッダーの値を取得します。
getId()Stringこのメッセージの ID を取得します。
getPlainBody()StringHTML 形式を使用せずに、このメッセージの本文を取得します。
getRawContent()Stringこのメッセージの未加工のコンテンツを取得します。
getReplyTo()Stringこのメッセージの返信先アドレス(通常は送信者)を取得します。
getSubject()Stringこのメッセージの件名を取得します。
getThread()GmailThreadこのメッセージを含むスレッドを取得します。
getTo()Stringこのメッセージのカンマ区切りの受信者を取得します。
isDraft()Booleanこのメッセージが下書きかどうかを取得します。
isInChats()Booleanこのメッセージがチャットであるかどうかを取得します。
isInInbox()Booleanこのメッセージが受信トレイにあるかどうかを取得します。
isInPriorityInbox()Booleanこのメッセージが優先受信トレイにある場合は true を返し、それ以外の場合は false を返します。
isInTrash()Booleanこのメッセージがゴミ箱にあるかどうかを取得します。
isStarred()Booleanこのメッセージにスターが付いているかどうかを確認します。
isUnread()Booleanこのメッセージが未読かどうかを取得します。
markRead()GmailMessageメッセージを既読にします。
markUnread()GmailMessageメッセージを未読としてマークします。
moveToTrash()GmailMessageメールをゴミ箱に移動します。
refresh()GmailMessageこのメッセージと、関連する状態を Gmail から再読み込みします(ラベル、読み取り状態などに変更があった場合に有用)。
reply(body)GmailMessageこのメッセージへの返信先アドレスを使用してこのメッセージの送信者に返信します。
reply(body, options)GmailMessageこのメッセージの返信先アドレスに、任意の引数とともに返信します。
replyAll(body)GmailMessageこのメッセージへの返信先アドレスとすべての受信者を使用して、送信者に返信します。
replyAll(body, options)GmailMessageこのメッセージへの返信先アドレスとすべての受信者を、オプションの引数とともに返信します。
star()GmailMessageメールにスターを付けます。
unstar()GmailMessageメールにスターを付けます。

詳細なドキュメント

createDraftReply(body)

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

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

パラメータ

名前説明
bodyStringメールの本文。

戻る

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

認可

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

  • https://mail.google.com/

関連ドキュメント


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

パラメータ

名前説明
bodyStringメールの本文。
optionsObject以下に示すように、高度なパラメータを指定する JavaScript オブジェクト。

拡張パラメータ

名前説明
attachmentsBlobSource[]メールで送信するファイルの配列
bccStringBCC 宛てのメールアドレスのカンマ区切りリスト
ccStringCc に含めるメールアドレスのカンマ区切りリスト
fromStringメールの送信元のアドレス(GmailApp.getAliases() によって返された値のいずれか)
htmlBodyString設定すると、HTML をレンダリングできるデバイスでは、必須の body 引数の代わりにこの属性が使用されます。メールのインライン画像がある場合は、HTML 本文にオプションの inlineImages フィールドを追加できます。
inlineImagesObject画像キー(String)から画像データ(BlobSource)へのマッピングを含む JavaScript オブジェクト。これは、htmlBody パラメータが使用され、これらの画像への参照が <img src="cid:imageKey" /> 形式で含まれていることを前提としています。
nameStringメールの送信者の名前(デフォルト: ユーザーの名前)
replyToStringデフォルトの返信先アドレスとして使用するメールアドレス(デフォルト: ユーザーのメールアドレス)
subjectStringメールの新しい件名

戻る

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

認可

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

  • https://mail.google.com/

関連ドキュメント


createDraftReplyAll(body)

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

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

パラメータ

名前説明
bodyStringメールの本文。

戻る

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

認可

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

  • https://mail.google.com/

関連ドキュメント


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

パラメータ

名前説明
bodyStringメールの本文。
optionsObject以下に示すように、高度なパラメータを指定する JavaScript オブジェクト。

拡張パラメータ

名前説明
attachmentsBlobSource[]メールで送信するファイルの配列
bccStringBCC 宛てのメールアドレスのカンマ区切りリスト
ccStringCc に含めるメールアドレスのカンマ区切りリスト
fromStringメールの送信元のアドレス(GmailApp.getAliases() によって返された値のいずれか)
htmlBodyString設定すると、HTML をレンダリングできるデバイスでは、必須の body 引数の代わりにこの属性が使用されます。メールのインライン画像がある場合は、HTML 本文にオプションの inlineImages フィールドを追加できます。
inlineImagesObject画像キー(String)から画像データ(BlobSource)へのマッピングを含む JavaScript オブジェクト。これは、htmlBody パラメータが使用され、これらの画像への参照が <img src="cid:imageKey" /> 形式で含まれていることを前提としています。
nameStringメールの送信者の名前(デフォルト: ユーザーの名前)
replyToStringデフォルトの返信先アドレスとして使用するメールアドレス(デフォルト: ユーザーのメールアドレス)
subjectStringメールの新しい件名

戻る

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

認可

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

  • https://mail.google.com/

関連ドキュメント


forward(recipient)

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

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

パラメータ

名前説明
recipientStringメールアドレスのカンマ区切りのリスト。

戻る

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

パラメータ

名前説明
recipientStringメールアドレスのカンマ区切りのリスト。
optionsObject以下に示すように、高度なパラメータを指定する JavaScript オブジェクト。

拡張パラメータ

名前説明
attachmentsBlobSource[]メールで送信するファイルの配列
bccStringBCC 宛てのメールアドレスのカンマ区切りリスト
ccStringCc に含めるメールアドレスのカンマ区切りリスト
fromStringメールの送信元のアドレス(GmailApp.getAliases() によって返された値のいずれか)
htmlBodyString設定すると、HTML をレンダリングできるデバイスでは、必須の body 引数の代わりにこの属性が使用されます。メールのインライン画像がある場合は、HTML 本文にオプションの inlineImages フィールドを追加できます。
inlineImagesObject画像キー(String)から画像データ(BlobSource)へのマッピングを含む JavaScript オブジェクト。これは、htmlBody パラメータが使用され、これらの画像への参照が <img src="cid:imageKey" /> 形式で含まれていることを前提としています。
nameStringメールの送信者の名前(デフォルト: ユーザーの名前)
noReplyBooleantrue: 受信者がメールに返信しないように、返信しない汎用的なメールアドレスからメールを送信する場合に必要です。このオプションは、Gmail ユーザーではなく、Google Workspace アカウントでのみ使用可能です。
replyToStringデフォルトの返信先アドレスとして使用するメールアドレス(デフォルト: ユーザーのメールアドレス)
subjectStringメールの新しい件名

戻る

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

認可

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

  • https://mail.google.com/

関連ドキュメント


getAttachments()

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

戻る

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

認可

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

  • https://mail.google.com/

getAttachments(options)

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

パラメータ

名前説明
optionsObject以下に示すように、高度なパラメータを指定する JavaScript オブジェクト。

拡張パラメータ

名前説明
includeInlineImagesBooleantrue は、返された Blob アタッチメントの配列にインライン画像を含める場合です(デフォルトは true)。
includeAttachmentsBooleantrue は、返された Blob アタッチメントの配列に、通常の(インラインではない)添付ファイルが含まれている場合です(デフォルトは true)。

戻る

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

認可

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

  • https://mail.google.com/

getBcc()

このメッセージの 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/

関連ドキュメント


getBody()

このメッセージの本文の 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/

関連ドキュメント


getCc()

このメッセージの 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/

関連ドキュメント


getDate()

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

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/

getFrom()

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

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/

関連ドキュメント


getHeader(name)

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.

パラメータ

名前説明
nameStringRFC ヘッダーの名前。コロンは値と区切りません。

戻る

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

認可

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

  • https://mail.google.com/

getId()

このメッセージの 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。


getPlainBody()

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/

関連ドキュメント


getRawContent()

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

戻る

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

認可

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

  • https://mail.google.com/

getReplyTo()

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

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/

関連ドキュメント


getSubject()

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

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/

関連ドキュメント


getThread()

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

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/

getTo()

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

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/

関連ドキュメント


isDraft()

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

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/

isInChats()

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

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 - このメッセージがチャットかどうかを指定します。


isInInbox()

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

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/

isInPriorityInbox()

このメッセージが優先受信トレイにある場合は 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/

isInTrash()

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

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 - このメッセージがゴミ箱にあるかどうか。


isStarred()

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

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 - このメッセージにスターが付いているかどうかを示します。


isUnread()

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

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/

markRead()

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

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/

関連ドキュメント


markUnread()

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

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/

関連ドキュメント


moveToTrash()

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

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/

関連ドキュメント


refresh()

このメッセージと、関連する状態を 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/

reply(body)

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

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

パラメータ

名前説明
bodyStringメールの本文。

戻る

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

認可

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

  • https://mail.google.com/

関連ドキュメント


reply(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
});

パラメータ

名前説明
bodyStringメールの本文。
optionsObject以下に示すように、高度なパラメータを指定する JavaScript オブジェクト。

拡張パラメータ

名前説明
attachmentsBlobSource[]メールで送信するファイルの配列
bccStringBCC 宛てのメールアドレスのカンマ区切りリスト
ccStringCc に含めるメールアドレスのカンマ区切りリスト
fromStringメールの送信元のアドレス(GmailApp.getAliases() によって返された値のいずれか)
htmlBodyString設定すると、HTML をレンダリングできるデバイスでは、必須の body 引数の代わりにこの属性が使用されます。メールのインライン画像がある場合は、HTML 本文にオプションの inlineImages フィールドを追加できます。
inlineImagesObject画像キー(String)から画像データ(BlobSource)へのマッピングを含む JavaScript オブジェクト。これは、htmlBody パラメータが使用され、これらの画像への参照が <img src="cid:imageKey" /> 形式で含まれていることを前提としています。
nameStringメールの送信者の名前(デフォルト: ユーザーの名前)
noReplyBooleantrue: 受信者がメールに返信しないように、返信しない汎用的なメールアドレスからメールを送信する場合に必要です。このオプションは、Gmail ユーザーではなく、Google Workspace アカウントでのみ使用可能です。
replyToStringデフォルトの返信先アドレスとして使用するメールアドレス(デフォルト: ユーザーのメールアドレス)
subjectStringメールの新しい件名

戻る

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

認可

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

  • https://mail.google.com/

関連ドキュメント


replyAll(body)

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

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

パラメータ

名前説明
bodyStringメールの本文。

戻る

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

認可

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

  • https://mail.google.com/

関連ドキュメント


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

パラメータ

名前説明
bodyStringメールの本文。
optionsObject以下に示すように、高度なパラメータを指定する JavaScript オブジェクト。

拡張パラメータ

名前説明
attachmentsBlobSource[]メールで送信するファイルの配列
bccStringBCC 宛てのメールアドレスのカンマ区切りリスト
ccStringCc に含めるメールアドレスのカンマ区切りリスト
fromStringメールの送信元のアドレス(GmailApp.getAliases() によって返された値のいずれか)
htmlBodyString設定すると、HTML をレンダリングできるデバイスでは、必須の body 引数の代わりにこの属性が使用されます。メールのインライン画像がある場合は、HTML 本文にオプションの inlineImages フィールドを追加できます。
inlineImagesObject画像キー(String)から画像データ(BlobSource)へのマッピングを含む JavaScript オブジェクト。これは、htmlBody パラメータが使用され、これらの画像への参照が <img src="cid:imageKey" /> 形式で含まれていることを前提としています。
nameStringメールの送信者の名前(デフォルト: ユーザーの名前)
noReplyBooleantrue: 受信者がメールに返信しないように、返信しない汎用的なメールアドレスからメールを送信する場合に必要です。このオプションは、Gmail ユーザーではなく、Google Workspace アカウントでのみ使用可能です。
replyToStringデフォルトの返信先アドレスとして使用するメールアドレス(デフォルト: ユーザーのメールアドレス)
subjectStringメールの新しい件名(最大 250 文字)

戻る

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

認可

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

  • https://mail.google.com/

関連ドキュメント


star()

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

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/

関連ドキュメント