Thư nháp do người dùng tạo trong tài khoản Gmail của người dùng.
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
deleteDraft() | void | Xoá thư nháp này. |
getId() | String | Lấy mã nhận dạng của thư nháp này. |
getMessage() | GmailMessage | Trả về một GmailMessage đại diện cho thư nháp này. |
getMessageId() | String | Trả về mã nhận dạng của GmailMessage đại diện cho bản nháp này. |
send() | GmailMessage | Gửi email nháp này. |
update(recipient, subject, body) | GmailDraft | Thay thế nội dung của thư nháp này. |
update(recipient, subject, body, options) | GmailDraft | Thay thế nội dung của thư nháp này bằng các đối số không bắt buộc. |
Tài liệu chi tiết
deleteDraft()
Xoá thư nháp này.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder draft.deleteDraft(); draft.getMessage(); // Throws exception.
Ủy quyền
Các 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 hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://mail.google.com/
getId()
Lấy mã nhận dạng của thư nháp này.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder var draftId = draft.getId(); var draftById = GmailApp.getDraft(draftId); Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());
Cầu thủ trả bóng
String
– mã bản nháp
Ủy quyền
Các 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 hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://mail.google.com/
getMessage()
Trả về một GmailMessage đại diện cho thư nháp này.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder var message = draft.getMessage(); Logger.log(message.getSubject());
Cầu thủ trả bóng
GmailMessage
— thông báo thể hiện nội dung của bản nháp này
Ủy quyền
Các 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 hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://mail.google.com/
getMessageId()
Trả về mã nhận dạng của GmailMessage
đại diện cho bản nháp này.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder var messageId = draft.getMessageId(); Logger.log(messageId == draft.getMessage().getId());
Cầu thủ trả bóng
String
– mã nhận dạng của thư
Ủy quyền
Các 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 hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://mail.google.com/
send()
Gửi email nháp này. Kích thước của email (bao gồm cả tiêu đề) là hạn mức.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder var msg = draft.send(); // Send it Logger.log(msg.getDate()); // Should be approximately the current timestamp
Cầu thủ trả bóng
GmailMessage
— tin nhắn mới được gửi
Ủy quyền
Các 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 hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://mail.google.com/
update(recipient, subject, body)
Thay thế nội dung của thư nháp này. Kích thước của email (bao gồm cả tiêu đề) là hạn mức.
// The code below will update a draft email with the current date and time. var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder var now = new Date(); draft.update("mike@example.com", "current time", "The time is: " + now.toString());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
recipient | String | danh sách địa chỉ email được phân tách bằng dấu phẩy |
subject | String | tiêu đề của email (tối đa 250 ký tự) |
body | String | nội dung email |
Cầu thủ trả bóng
GmailDraft
– bản nháp mới được cập nhật
Ủy quyền
Các 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 hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://mail.google.com/
Xem thêm
update(recipient, subject, body, options)
Thay thế nội dung của thư nháp này bằng các đối số không bắt buộc. Email có thể chứa văn bản thuần tuý hoặc nội dung HTML. Kích thước của email (bao gồm cả tiêu đề) là hạn mức.
// Update a draft email with a file from Google Drive attached as a PDF. var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz'); draft.update('mike@example.com', 'Attachment example', 'Please see attached file.', { attachments: [file.getAs(MimeType.PDF)], name: 'Automatic Emailer Script' });
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
recipient | String | danh sách địa chỉ email được phân tách bằng dấu phẩy |
subject | String | tiêu đề của email (tối đa 250 ký tự) |
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 |
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 |
from | String | địa chỉ dùng để gửi email. Địa chỉ này phải là một trong những giá trị được GmailApp.getAliases() trả về |
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) |
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) |
Cầu thủ trả bóng
GmailDraft
– bản nháp mới được cập nhật
Ủy quyền
Các 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 hoặc phạm vi thích hợp sau đây từ API REST có liên quan:
-
https://mail.google.com/