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 hộp thư đến Gmail của người dùng.
Các thay đổi đối với tập lệnh được viết bằng GmailApp có nhiều khả năng kích hoạt yêu cầu uỷ quyền lại từ người dùng hơn so với tập lệnh MailApp.
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
getRemainingDailyQuota() | Integer | Trả về số lượng người nhận mà bạn có thể gửi email đến trong thời gian còn lại trong ngày. |
sendEmail(message) | void | Gửi một email. |
sendEmail(recipient, subject, body) | void | Gửi một 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 một email. |
Tài liệu chi tiết
getRemainingDailyQuota()
Trả về số lượng người nhận mà bạn có thể gửi email đến trong thời gian còn lại trong ngày. Giá trị được trả về hợp lệ cho lượt thực thi hiện tại và có thể khác nhau giữa các lượt thực thi.
Hạn mức được xác định 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 các Dịch vụ của Google.
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 cần được uỷ 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 một email. Biến thể này của phương thức linh hoạt hơn nhiều, cho phép có nhiều tuỳ chọn hơn.
// 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 } }); }
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
message | Object | đối tượng JavaScript đại diện cho một email |
Thông số nâng cao
Tên | Loại | Nội dung 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 gửi đến BCC được phân tách bằng dấu phẩy |
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 |
htmlBody | String | nếu được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng mã này thay vì đố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 nội dung HTML nếu bạn có hình ảnh cùng dòng cho email của mình |
inlineImages | Object | một đối tượng JavaScript chứa đường liên kết từ khoá hình ảnh (String ) đến dữ liệu hình ảnh (BlobSource ); điều này giả định rằng tham số htmlBody được sử dụng và chứa thông tin tham chiếu đến những hình ảnh này theo định dạng <img src="cid:imageKey" /> (xem ví dụ) |
name | String | tên người gửi email. Giá trị mặc định là tên người dùng của người gửi. |
noReply | Boolean | true nếu email được gửi từ một
địa chỉ email chung không nhận thư trả lời để ngăn người nhận trả lời email. Tuỳ chọn này
chỉ áp dụng cho tài khoản Google Workspace, không dùng được cho người dùng Gmail |
replyTo | String | địa chỉ email để 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 , 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ác địa chỉ email được phân tách bằng dấu phẩy sẽ là người nhận |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ 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)
Gửi một email.
MailApp.sendEmail("recipient@example.com", "TPS reports", "Where are the TPS reports?");
Các tham số
Tên | Loại | Nội dung 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 cần được uỷ 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] });
Các tham số
Tên | Loại | Nội dung 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ê dưới đây |
Thông số nâng cao
Tên | Loại | Nội dung 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 gửi đến BCC được phân tách bằng dấu phẩy |
cc | String | danh sách địa chỉ email được phân tách bằng dấu phẩy |
htmlBody | String | nếu được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng mã này thay vì đố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 nội dung HTML nếu bạn có hình ảnh cùng dòng cho email của mình |
inlineImages | Object | một đối tượng JavaScript chứa đường liên kết từ khoá hình ảnh (String ) đến dữ liệu hình ảnh (BlobSource ); điều này giả định rằng tham số htmlBody được sử dụng và 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 của người gửi email (mặc định: tên của người dùng) |
noReply | Boolean | true nếu email được gửi từ một
địa chỉ email chung không nhận thư trả lời để ngăn người nhận trả lời email. Tuỳ chọn này
chỉ áp dụng cho tài khoản Google Workspace, không dùng được cho người dùng Gmail |
replyTo | String | địa chỉ email để 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 cần được uỷ 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(to, replyTo, subject, body)
Gửi một 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 thư đã 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?");
Các tham số
Tên | Loại | Nội dung 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 ở dạng văn bản thuần tuý |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/script.send_mail