本頁面由 Cloud Translation API 翻譯而成。

Class MailApp

傳送電子郵件。

這項服務可讓使用者傳送電子郵件，完全掌控電子郵件內容。與 GmailApp 不同的是，MailApp 的唯一用途是傳送電子郵件。MailApp 無法存取使用者的 Gmail 。

對使用 Gmail 應用程式編寫的指令碼所做的變更更有可能觸發重新授權而非 MailApp 指令碼

方法

方法	傳回類型	簡短說明
`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: "recipient@example.com",
    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 的裝置會改用這個程式碼所需的 body 引數之一；您可以視需要在 HTML 中新增 `inlineImages` 欄位電子郵件內文 (如果電子郵件含有內嵌圖片)
`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, options)

`sendEmail(recipient, subject, body)`

傳送電子郵件。

MailApp.sendEmail("recipient@example.com",
                  "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('mike@example.com', '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 的裝置會改用這個程式碼所需的 body 引數之一；您可以視需要在 HTML 中新增 `inlineImages` 欄位電子郵件內文 (如果電子郵件含有內嵌圖片)
`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(message)

`sendEmail(to, replyTo, subject, body)`

傳送電子郵件。這個方法可讓使用者輕鬆指定「回覆」地址卻可能與寄件者不同的訊息

MailApp.sendEmail("recipient@example.com",
                  "replies@example.com",
                  "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