Class MailApp

MailApp

发送电子邮件。

借助此服务,用户可以完全控制电子邮件的内容。 与 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
      }
  });
}

参数

名称类型说明
messageObject表示电子邮件的 JavaScript 对象

高级参数

名称类型说明
attachmentsBlobSource[]一 随电子邮件地址一起发送的文件数组
bccString要密送的电子邮件地址的逗号分隔列表
bodyString电子邮件正文
ccString要抄送的电子邮件地址的逗号分隔列表
htmlBodyString如果已设置,则能够呈现 HTML 的设备将改用 HTML 源代码。 所需的 body 参数;您可以在 HTML 中添加一个可选的 inlineImages 字段 body(如果您的电子邮件有内嵌图片)
inlineImagesObject包含图片键映射的 JavaScript 对象 (String) 对图片数据 (BlobSource);这里假定使用了 htmlBody 参数,并以 <img src="cid:imageKey" /> 格式包含对这些图片的引用(参见示例)
nameString电子邮件发件人的姓名。默认为发件人的 用户名。
noReplyBoolean如果电子邮件应通过通用电子邮件地址发送,则为 true 无回复电子邮件地址,旨在阻止收件人回复电子邮件;此选项为 仅适用于 Google Workspace 账号,不适用于 Gmail 用户
replyToString用作默认回复地址的电子邮件地址 (默认值:用户的电子邮件地址)。如果 noReply 设置为 true,系统会忽略 replyTo
subjectString电子邮件的主题
toString收件人的电子邮件地址或以逗号分隔的 作为收件人的电子邮件地址

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

  • https://www.googleapis.com/auth/script.send_mail

另请参阅


sendEmail(recipient, subject, body)

发送电子邮件。

MailApp.sendEmail("[email protected]",
                  "TPS reports",
                  "Where are the TPS reports?");

参数

名称类型说明
recipientString收件人地址(用英文逗号分隔)
subjectString主题行
bodyString电子邮件正文

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

参数

名称类型说明
recipientString收件人地址(用英文逗号分隔)
subjectString主题行
bodyString电子邮件正文
optionsObject一个用于指定高级参数(如下所列)的 JavaScript 对象

高级参数

名称类型说明
attachmentsBlobSource[]一 随电子邮件地址一起发送的文件数组(请参阅示例)
bccString要密送的电子邮件地址的逗号分隔列表
ccString要抄送的电子邮件地址的逗号分隔列表
htmlBodyString如果已设置,则能够呈现 HTML 的设备将改用 HTML 源代码。 所需的 body 参数;您可以在 HTML 中添加一个可选的 inlineImages 字段 body(如果您的电子邮件有内嵌图片)
inlineImagesObject包含图片键映射的 JavaScript 对象 (String) 对图片数据 (BlobSource);这里假定使用了 htmlBody 参数,并以 <img src="cid:imageKey" /> 格式包含对这些图片的引用
nameString电子邮件发件人的姓名(默认:用户的姓名)
noReplyBoolean如果电子邮件应通过通用电子邮件地址发送,则为 true 无回复电子邮件地址,旨在阻止收件人回复电子邮件;此选项为 仅适用于 Google Workspace 账号,不适用于 Gmail 用户
replyToString用作默认回复地址的电子邮件地址 (默认值:用户的电子邮件地址)

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

  • 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?");

参数

名称类型说明
toString收件人地址(用英文逗号分隔)
replyToString回复地址
subjectString主题行
bodyString纯文本格式的电子邮件正文

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

  • https://www.googleapis.com/auth/script.send_mail