此页面由 Cloud Translation API 翻译。

Class GmailMessage

用户 Gmail 账号中的邮件。

方法

方法	返回类型	简介
`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`	获取此邮件中密送的收件人（以英文逗号分隔）。
`getBody()`	`String`	获取该邮件正文的 HTML 内容。
`getCc()`	`String`	获取此邮件的抄送收件人（以逗号分隔）。
`getDate()`	`Date`	获取该邮件的日期和时间。
`getFrom()`	`String`	获取该邮件的发件人。
`getHeader(name)`	`String`	根据标头名称获取 RFC 2822 标头的值。
`getId()`	`String`	获取此消息的 ID。
`getPlainBody()`	`String`	获取该邮件的正文内容，不带 HTML 格式。
`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");

参数

名称	类型	说明
`body`	`String`	电子邮件正文。

GmailDraft - 新创建的消息草稿。

授权

使用此方法的脚本需要以下一个或多个范围或相关 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"
});

参数

名称	类型	说明
`body`	`String`	电子邮件正文。
`options`	`Object`	一个 JavaScript 对象，用于指定下列高级参数。

高级参数

名称	类型	说明
`attachments`	`BlobSource[]`	一随电子邮件地址一起发送的文件数组
`bcc`	`String`	要密送的电子邮件地址的逗号分隔列表
`cc`	`String`	要抄送的电子邮件地址的逗号分隔列表
`from`	`String`	发送电子邮件的发件地址，必须为该地址的 `GmailApp.getAliases()` 返回的值
`htmlBody`	`String`	设置后，能够呈现 HTML 的设备会使用该属性，而不是必需的 body 参数；您可以在 HTML 正文中添加可选的 `inlineImages` 字段如果您的电子邮件有内嵌图片
`inlineImages`	`Object`	包含图片键映射的 JavaScript 对象 (`String`) 对图片数据 (`BlobSource`)；这里假定使用了 `htmlBody` 参数，并以 `<img src="cid:imageKey" />` 格式包含对这些图片的引用
`name`	`String`	电子邮件发件人的姓名（默认：用户的姓名）
`replyTo`	`String`	用作默认回复地址的电子邮件地址（默认值：用户的电子邮件地址）
`subject`	`String`	新的电子邮件主题行，最多 250 个字符。

GmailDraft - 新创建的消息草稿。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

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

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

参数

名称	类型	说明
`body`	`String`	电子邮件正文。

GmailDraft - 新创建的消息草稿。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

replyAll(body)
createDraftReply(body)
createDraftReply(body, options)
createDraftReplyAll(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"
});

参数

名称	类型	说明
`body`	`String`	电子邮件正文。
`options`	`Object`	一个 JavaScript 对象，用于指定下列高级参数。

高级参数

名称	类型	说明
`attachments`	`BlobSource[]`	一随电子邮件地址一起发送的文件数组
`bcc`	`String`	要密送的电子邮件地址的逗号分隔列表
`cc`	`String`	要抄送的电子邮件地址的逗号分隔列表
`from`	`String`	发送电子邮件的发件地址，必须为该地址的 `GmailApp.getAliases()` 返回的值
`htmlBody`	`String`	设置后，能够呈现 HTML 的设备会使用该属性，而不是必需的 body 参数；您可以在 HTML 正文中添加可选的 `inlineImages` 字段如果您的电子邮件有内嵌图片
`inlineImages`	`Object`	包含图片键映射的 JavaScript 对象 (`String`) 对图片数据 (`BlobSource`)；这里假定使用了 `htmlBody` 参数，并以 `<img src="cid:imageKey" />` 格式包含对这些图片的引用
`name`	`String`	电子邮件发件人的姓名（默认：用户的姓名）
`replyTo`	`String`	用作默认回复地址的电子邮件地址（默认值：用户的电子邮件地址）
`subject`	`String`	新的电子邮件主题行，最多 250 个字符。

GmailDraft - 新创建的消息草稿。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

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

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

参数

名称	类型	说明
`recipient`	`String`	以英文逗号分隔的电子邮件地址列表。

GmailMessage - 此消息，在进行链接时很有用。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

forward(recipient, options)

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

参数

名称	类型	说明
`recipient`	`String`	以英文逗号分隔的电子邮件地址列表。
`options`	`Object`	一个 JavaScript 对象，用于指定下列高级参数。

高级参数

名称	类型	说明
`attachments`	`BlobSource[]`	一随电子邮件地址一起发送的文件数组
`bcc`	`String`	要密送的电子邮件地址的逗号分隔列表
`cc`	`String`	要抄送的电子邮件地址的逗号分隔列表
`from`	`String`	发送电子邮件的发件地址，必须为该地址的 `GmailApp.getAliases()` 返回的值
`htmlBody`	`String`	设置后，能够呈现 HTML 的设备会使用该属性，而不是必需的 body 参数；您可以在 HTML 正文中添加可选的 `inlineImages` 字段如果您的电子邮件有内嵌图片
`inlineImages`	`Object`	包含图片键映射的 JavaScript 对象 (`String`) 对图片数据 (`BlobSource`)；这里假定使用了 `htmlBody` 参数，并以 `<img src="cid:imageKey" />` 格式包含对这些图片的引用
`name`	`String`	电子邮件发件人的姓名（默认：用户的姓名）
`noReply`	`Boolean`	如果电子邮件应通过通用电子邮件地址发送，则为 `true` 无回复电子邮件地址，旨在阻止收件人回复电子邮件；此选项为仅适用于 Google Workspace 账号，不适用于 Gmail 用户
`replyTo`	`String`	用作默认回复地址的电子邮件地址（默认值：用户的电子邮件地址）
`subject`	`String`	新的电子邮件主题行，最多 250 个字符。

GmailMessage - 此消息，在进行链接时很有用。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

forward(recipient)

`getAttachments()`

获取该邮件的所有附件。

GmailAttachment[] - 该邮件的 Blob 附件数组。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

`getAttachments(options)`

获取该邮件的所有附件。

参数

名称	类型	说明
`options`	`Object`	一个 JavaScript 对象，用于指定下列高级参数。

高级参数

名称	类型	说明
`includeInlineImages`	`Boolean`	如果返回的 Blob 数组，则为 `true` 附件应包含内嵌图片（默认为 `true`）。
`includeAttachments`	`Boolean`	如果返回的 Blob 数组，则为 `true` 附件应包含常规（非内嵌）附件（默认为 `true`）。

GmailAttachment[] - 该邮件的 Blob 附件数组。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

`getBcc()`

获取此邮件中密送的收件人（以英文逗号分隔）。

根据定义，对于所有收到的消息，此字段都是空的。

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 - 邮件密送至的收件人（以英文逗号分隔）。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

getTo()

`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 - 该邮件的正文内容。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

getSubject()

`getCc()`

获取此邮件的抄送收件人（以逗号分隔）。

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 - 此邮件抄送的收件人（以英文逗号分隔）。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

getTo()

`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 - 该邮件的日期和时间。

授权

使用此方法的脚本需要以下一个或多个范围或相关 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 - 邮件发件人的电子邮件地址。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

getReplyTo()

`getHeader(name)`

根据标头名称获取 RFC 2822 标头的值。

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.

参数

名称	类型	说明
`name`	`String`	RFC 标头的名称，使用英文冒号将值与值分隔开。

String - 标头的值，如果消息中不存在标头，则为空字符串。

授权

使用此方法的脚本需要以下一个或多个范围或相关 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 - 该邮件的普通正文内容。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

getSubject()

`getRawContent()`

获取此消息的原始内容。效果等同于“显示原始邮件”。

String - 此消息的原始内容。

授权

使用此方法的脚本需要以下一个或多个范围或相关 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 - 用于回复的电子邮件地址。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

getCc()

`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 - 该邮件的主题。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

getAttachments()

`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。

授权

使用此方法的脚本需要以下一个或多个范围或相关 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 - 该邮件的收件人（以英文逗号分隔）。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

getCc()

`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 - 表示此邮件是否为草稿。

授权

使用此方法的脚本需要以下一个或多个范围或相关 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 - 此邮件是否在收件箱中。

授权

使用此方法的脚本需要以下一个或多个范围或相关 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 - 此邮件是否在优先收件箱中。

授权

使用此方法的脚本需要以下一个或多个范围或相关 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 - 此消息的未读状态。

授权

使用此方法的脚本需要以下一个或多个范围或相关 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，可用于进行链接。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

isUnread()

`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，可用于进行链接。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

isUnread()

`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，可用于进行链接。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

isInTrash()

`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 - 此消息用于链路。

授权

使用此方法的脚本需要以下一个或多个范围或相关 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");

参数

名称	类型	说明
`body`	`String`	电子邮件正文。

GmailMessage - 此消息，在进行链接时很有用。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

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

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

参数

名称	类型	说明
`body`	`String`	电子邮件正文。
`options`	`Object`	一个 JavaScript 对象，用于指定下列高级参数。

高级参数

名称	类型	说明
`attachments`	`BlobSource[]`	一随电子邮件地址一起发送的文件数组
`bcc`	`String`	要密送的电子邮件地址的逗号分隔列表
`cc`	`String`	要抄送的电子邮件地址的逗号分隔列表
`from`	`String`	发送电子邮件的发件地址，必须为该地址的 `GmailApp.getAliases()` 返回的值
`htmlBody`	`String`	设置后，能够呈现 HTML 的设备会使用该属性，而不是必需的 body 参数；您可以在 HTML 正文中添加可选的 `inlineImages` 字段如果您的电子邮件有内嵌图片
`inlineImages`	`Object`	包含图片键映射的 JavaScript 对象 (`String`) 对图片数据 (`BlobSource`)；这里假定使用了 `htmlBody` 参数，并以 `<img src="cid:imageKey" />` 格式包含对这些图片的引用
`name`	`String`	电子邮件发件人的姓名（默认：用户的姓名）
`noReply`	`Boolean`	如果电子邮件应通过通用电子邮件地址发送，则为 `true` 无回复电子邮件地址，旨在阻止收件人回复电子邮件；此选项为仅适用于 Google Workspace 账号，不适用于 Gmail 用户
`replyTo`	`String`	用作默认回复地址的电子邮件地址（默认值：用户的电子邮件地址）
`subject`	`String`	新的电子邮件主题行，最多 250 个字符。

GmailMessage - 此消息，在进行链接时很有用。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

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

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

参数

名称	类型	说明
`body`	`String`	电子邮件正文。

GmailMessage - 此消息，在进行链接时很有用。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

reply(body)
reply(body, options)
replyAll(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
});

参数

名称	类型	说明
`body`	`String`	电子邮件正文。
`options`	`Object`	一个 JavaScript 对象，用于指定下列高级参数。

高级参数

名称	类型	说明
`attachments`	`BlobSource[]`	一随电子邮件地址一起发送的文件数组
`bcc`	`String`	要密送的电子邮件地址的逗号分隔列表
`cc`	`String`	要抄送的电子邮件地址的逗号分隔列表
`from`	`String`	发送电子邮件的发件地址，必须为该地址的 `GmailApp.getAliases()` 返回的值
`htmlBody`	`String`	设置后，能够呈现 HTML 的设备会使用该属性，而不是必需的 body 参数；您可以在 HTML 正文中添加可选的 `inlineImages` 字段如果您的电子邮件有内嵌图片
`inlineImages`	`Object`	包含图片键映射的 JavaScript 对象 (`String`) 对图片数据 (`BlobSource`)；这里假定使用了 `htmlBody` 参数，并以 `<img src="cid:imageKey" />` 格式包含对这些图片的引用
`name`	`String`	电子邮件发件人的姓名（默认：用户的姓名）
`noReply`	`Boolean`	如果电子邮件应通过通用电子邮件地址发送，则为 `true` 无回复电子邮件地址，旨在阻止收件人回复电子邮件；此选项为仅适用于 Google Workspace 账号，不适用于 Gmail 用户
`replyTo`	`String`	用作默认回复地址的电子邮件地址（默认值：用户的电子邮件地址）
`subject`	`String`	新的电子邮件主题行，最多 250 个字符。

GmailMessage - 此消息，在进行链接时很有用。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

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

`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，可用于进行链接。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

unstar()

`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，可用于进行链接。

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

https://mail.google.com/

另请参阅

star()