Trang này được dịch bởi Cloud Translation API.

Class MailApp

Gửi email.

Dịch vụ này cho phép người dùng gửi email với toàn quyền kiểm soát nội dung email. Không giống như GmailApp, mục đích duy nhất của MailApp là gửi email. MailApp không thể truy cập vào Gmail của người dùng hộp thư đến.

Những thay đổi đối với các tập lệnh được viết bằng GmailApp có nhiều khả năng kích hoạt quá trình cấp phép lại từ một người dùng so với tập lệnh MailApp.

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`getRemainingDailyQuota()`	`Integer`	Trả về số người nhận mà bạn có thể gửi email cho thời gian còn lại trong ngày.
`sendEmail(message)`	`void`	Gửi email.
`sendEmail(recipient, subject, body)`	`void`	Gửi email.
`sendEmail(recipient, subject, body, options)`	`void`	Gửi email có các đối số không bắt buộc.
`sendEmail(to, replyTo, subject, body)`	`void`	Gửi email.

Tài liệu chi tiết

`getRemainingDailyQuota()`

Trả về số người nhận mà bạn có thể gửi email cho thời gian còn lại trong ngày. Được trả về có giá trị hợp lệ cho lần thực thi hiện tại và có thể khác nhau giữa các lần thực thi.

Hạn mức dựa trên số lượng người nhận email. Để biết thông tin cụ thể về hạn mức, hãy xem bài viết Hạn mức cho Google Dịch vụ.

var emailQuotaRemaining = MailApp.getRemainingDailyQuota();
Logger.log("Remaining email quota: " + emailQuotaRemaining);

Cầu thủ trả bóng

Integer — Số email còn lại mà tập lệnh có thể gửi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`sendEmail(message)`

Gửi email. Biến thể này của phương thức linh hoạt hơn nhiều, cho phép nhiều tuỳ chọn khác.

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

Tham số

Tên	Loại	Mô tả
`message`	`Object`	đối tượng JavaScript đại diện cho thông báo email

Thông số nâng cao

Tên	Loại	Mô tả
`attachments`	`BlobSource[]`	một mảng tệp để gửi cùng với email
`bcc`	`String`	danh sách địa chỉ email được phân tách bằng dấu phẩy tới BCC
`body`	`String`	nội dung email
`cc`	`String`	danh sách địa chỉ email được phân tách bằng dấu phẩy để gửi CC
`htmlBody`	`String`	nếu được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng HTML này của đối số nội dung bắt buộc; bạn có thể thêm trường `inlineImages` (không bắt buộc) trong HTML nội dung nếu bạn có hình ảnh cùng dòng cho email của mình
`inlineImages`	`Object`	đối tượng JavaScript chứa ánh xạ từ khoá hình ảnh (`String`) thành dữ liệu hình ảnh (`BlobSource`); điều này giả định rằng tham số `htmlBody` được sử dụng và có chứa thông tin tham chiếu đến những hình ảnh này ở định dạng `<img src="cid:imageKey" />` (xem ví dụ)
`name`	`String`	tên người gửi email. Mặc định là của người gửi tên người dùng.
`noReply`	`Boolean`	`true` nếu email phải được gửi từ một email chung địa chỉ email không trả lời để ngăn người nhận trả lời email; tuỳ chọn này là chỉ dành cho tài khoản Google Workspace, không áp dụng cho người dùng Gmail
`replyTo`	`String`	địa chỉ email để sử dụng làm địa chỉ trả lời mặc định (mặc định: địa chỉ email của người dùng). Nếu bạn đặt `noReply` thành `true` thì `replyTo` sẽ bị bỏ qua.
`subject`	`String`	tiêu đề của email
`to`	`String`	địa chỉ email của người nhận hoặc danh sách được phân tách bằng dấu phẩy địa chỉ email làm người nhận

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

sendEmail(recipient, subject, body, options)

`sendEmail(recipient, subject, body)`

Gửi email.

MailApp.sendEmail("recipient@example.com",
                  "TPS reports",
                  "Where are the TPS reports?");

Tham số

Tên	Loại	Mô tả
`recipient`	`String`	địa chỉ của người nhận, được phân tách bằng dấu phẩy
`subject`	`String`	dòng tiêu đề
`body`	`String`	nội dung email

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`sendEmail(recipient, subject, body, options)`

Gửi email có các đối số không bắt buộc.

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

Tham số

Tên	Loại	Mô tả
`recipient`	`String`	địa chỉ của người nhận, được phân tách bằng dấu phẩy
`subject`	`String`	dòng tiêu đề
`body`	`String`	nội dung email
`options`	`Object`	đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới

Thông số nâng cao

Tên	Loại	Mô tả
`attachments`	`BlobSource[]`	một mảng tệp để gửi cùng với email (xem ví dụ)
`bcc`	`String`	danh sách địa chỉ email được phân tách bằng dấu phẩy tới BCC
`cc`	`String`	danh sách địa chỉ email được phân tách bằng dấu phẩy để gửi CC
`htmlBody`	`String`	nếu được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng HTML này của đối số nội dung bắt buộc; bạn có thể thêm trường `inlineImages` (không bắt buộc) trong HTML nội dung nếu bạn có hình ảnh cùng dòng cho email của mình
`inlineImages`	`Object`	đối tượng JavaScript chứa ánh xạ từ khoá hình ảnh (`String`) thành dữ liệu hình ảnh (`BlobSource`); điều này giả định rằng tham số `htmlBody` được sử dụng và có chứa thông tin tham chiếu đến những hình ảnh này ở định dạng `<img src="cid:imageKey" />`
`name`	`String`	tên người gửi email (mặc định: tên của người dùng)
`noReply`	`Boolean`	`true` nếu email phải được gửi từ một email chung địa chỉ email không trả lời để ngăn người nhận trả lời email; tuỳ chọn này là chỉ dành cho tài khoản Google Workspace, không áp dụng cho người dùng Gmail
`replyTo`	`String`	địa chỉ email để sử dụng làm địa chỉ trả lời mặc định (mặc định: địa chỉ email của người dùng)

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

sendEmail(message)

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

Gửi email. Phương thức này cho phép người dùng dễ dàng chỉ định địa chỉ Trả lời cho tin nhắn đã gửi có thể khác với người gửi.

MailApp.sendEmail("recipient@example.com",
                  "replies@example.com",
                  "TPS report status",
                  "What is the status of those TPS reports?");

Tham số

Tên	Loại	Mô tả
`to`	`String`	địa chỉ của người nhận, được phân tách bằng dấu phẩy
`replyTo`	`String`	địa chỉ trả lời
`subject`	`String`	dòng tiêu đề
`body`	`String`	nội dung email bằng văn bản thuần tuý

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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