发送电子邮件。
借助此服务,用户可以完全控制电子邮件的内容。 与 GmailApp 不同,MailApp 的唯一用途是发送电子邮件。MailApp 无法访问用户的 Gmail 收件箱。
对使用 GmailApp 编写的脚本进行更改更有可能触发重新授权 从用户请求发送的内容。
方法
方法 | 返回类型 | 简介 |
---|---|---|
getRemainingDailyQuota() | Integer | 返回当天剩余时间内您可以向其发送电子邮件的收件人数量。 |
sendEmail(message) | void | 发送电子邮件。 |
sendEmail(recipient, subject, body) | void | 发送电子邮件。 |
sendEmail(recipient, subject, body, options) | void | 发送带有可选参数的电子邮件。 |
sendEmail(to, replyTo, subject, body) | void | 发送电子邮件。 |
详细文档
getRemainingDailyQuota()
返回当天剩余时间内您可以向其发送电子邮件的收件人数量。返回的 值对当前执行有效,可能会因执行而异。
配额基于电子邮件收件人的数量。如需了解具体的配额信息,请参阅 Google 配额 服务。
var emailQuotaRemaining = MailApp.getRemainingDailyQuota(); Logger.log("Remaining email quota: " + emailQuotaRemaining);
返回
Integer
- 脚本可以发送的剩余电子邮件数量。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/script.send_mail
sendEmail(message)
发送电子邮件。这种方法的这种变化更加灵活, 更多选项。
// This code fetches the Google and YouTube logos, inlines them in an email // and sends the email function inlineImage() { var googleLogoUrl = "https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png"; var youtubeLogoUrl = "https://developers.google.com/youtube/images/YouTube_logo_standard_white.png"; var googleLogoBlob = UrlFetchApp .fetch(googleLogoUrl) .getBlob() .setName("googleLogoBlob"); var youtubeLogoBlob = UrlFetchApp .fetch(youtubeLogoUrl) .getBlob() .setName("youtubeLogoBlob"); MailApp.sendEmail({ to: "[email protected]", subject: "Logos", htmlBody: "inline Google Logo<img src='cid:googleLogo'> images! <br>" + "inline YouTube Logo <img src='cid:youtubeLogo'>", inlineImages: { googleLogo: googleLogoBlob, youtubeLogo: youtubeLogoBlob } }); }
参数
名称 | 类型 | 说明 |
---|---|---|
message | Object | 表示电子邮件的 JavaScript 对象 |
高级参数
名称 | 类型 | 说明 |
---|---|---|
attachments | BlobSource[] | 一 随电子邮件地址一起发送的文件数组 |
bcc | String | 要密送的电子邮件地址的逗号分隔列表 |
body | String | 电子邮件正文 |
cc | String | 要抄送的电子邮件地址的逗号分隔列表 |
htmlBody | String | 如果已设置,则能够呈现 HTML 的设备将改用 HTML 源代码。
所需的 body 参数;您可以在 HTML 中添加一个可选的 inlineImages 字段
body(如果您的电子邮件有内嵌图片) |
inlineImages | Object | 包含图片键映射的 JavaScript 对象
(String ) 对图片数据 (BlobSource );这里假定使用了 htmlBody 参数,并以 <img src="cid:imageKey" /> 格式包含对这些图片的引用(参见示例) |
name | String | 电子邮件发件人的姓名。默认为发件人的 用户名。 |
noReply | Boolean | 如果电子邮件应通过通用电子邮件地址发送,则为 true
无回复电子邮件地址,旨在阻止收件人回复电子邮件;此选项为
仅适用于 Google Workspace 账号,不适用于 Gmail 用户 |
replyTo | String | 用作默认回复地址的电子邮件地址
(默认值:用户的电子邮件地址)。如果 noReply 设置为 true ,系统会忽略 replyTo 。 |
subject | String | 电子邮件的主题 |
to | String | 收件人的电子邮件地址或以逗号分隔的 作为收件人的电子邮件地址 |
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/script.send_mail
另请参阅
sendEmail(recipient, subject, body)
发送电子邮件。
MailApp.sendEmail("[email protected]", "TPS reports", "Where are the TPS reports?");
参数
名称 | 类型 | 说明 |
---|---|---|
recipient | String | 收件人地址(用英文逗号分隔) |
subject | String | 主题行 |
body | String | 电子邮件正文 |
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/script.send_mail
sendEmail(recipient, subject, body, options)
发送带有可选参数的电子邮件。
// Send an email with two attachments: a file from Google Drive (as a PDF) and an HTML file. var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz'); var blob = Utilities.newBlob('Insert any HTML content here', 'text/html', 'my_document.html'); MailApp.sendEmail('[email protected]', 'Attachment example', 'Two files are attached.', { name: 'Automatic Emailer Script', attachments: [file.getAs(MimeType.PDF), blob] });
参数
名称 | 类型 | 说明 |
---|---|---|
recipient | String | 收件人地址(用英文逗号分隔) |
subject | String | 主题行 |
body | String | 电子邮件正文 |
options | Object | 一个用于指定高级参数(如下所列)的 JavaScript 对象 |
高级参数
名称 | 类型 | 说明 |
---|---|---|
attachments | BlobSource[] | 一 随电子邮件地址一起发送的文件数组(请参阅示例) |
bcc | String | 要密送的电子邮件地址的逗号分隔列表 |
cc | String | 要抄送的电子邮件地址的逗号分隔列表 |
htmlBody | String | 如果已设置,则能够呈现 HTML 的设备将改用 HTML 源代码。
所需的 body 参数;您可以在 HTML 中添加一个可选的 inlineImages 字段
body(如果您的电子邮件有内嵌图片) |
inlineImages | Object | 包含图片键映射的 JavaScript 对象
(String ) 对图片数据 (BlobSource );这里假定使用了 htmlBody 参数,并以 <img src="cid:imageKey" /> 格式包含对这些图片的引用 |
name | String | 电子邮件发件人的姓名(默认:用户的姓名) |
noReply | Boolean | 如果电子邮件应通过通用电子邮件地址发送,则为 true
无回复电子邮件地址,旨在阻止收件人回复电子邮件;此选项为
仅适用于 Google Workspace 账号,不适用于 Gmail 用户 |
replyTo | String | 用作默认回复地址的电子邮件地址 (默认值:用户的电子邮件地址) |
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/script.send_mail
另请参阅
sendEmail(to, replyTo, subject, body)
发送电子邮件。通过这种方法,用户可以轻松地为 (可能与发件人不同)的消息。
MailApp.sendEmail("[email protected]", "[email protected]", "TPS report status", "What is the status of those TPS reports?");
参数
名称 | 类型 | 说明 |
---|---|---|
to | String | 收件人地址(用英文逗号分隔) |
replyTo | String | 回复地址 |
subject | String | 主题行 |
body | String | 纯文本格式的电子邮件正文 |
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/script.send_mail