Class GmailDraft

GmailDraft

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ứcKiểu dữ liệu trả vềMô tả ngắn
deleteDraft()voidXoá thư nháp này.
getId()StringLấy mã nhận dạng của thư nháp này.
getMessage()GmailMessageTrả về một GmailMessage đại diện cho thư nháp này.
getMessageId()StringTrả về mã nhận dạng của GmailMessage đại diện cho bản nháp này.
send()GmailMessageGửi email nháp này.
update(recipient, subject, body)GmailDraftThay thế nội dung của thư nháp này.
update(recipient, subject, body, options)GmailDraftThay 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ênLoạiNội dung mô tả
recipientStringdanh sách địa chỉ email được phân tách bằng dấu phẩy
subjectStringtiêu đề của email (tối đa 250 ký tự)
bodyStringnộ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ênLoạiNội dung mô tả
recipientStringdanh sách địa chỉ email được phân tách bằng dấu phẩy
subjectStringtiêu đề của email (tối đa 250 ký tự)
bodyStringnội dung email
optionsObjectđố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ênLoạiNội dung mô tả
attachmentsBlobSource[]một mảng tệp để gửi cùng với email
bccStringdanh sách địa chỉ email gửi đến BCC được phân tách bằng dấu phẩy
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy
fromStringđị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ề
htmlBodyStringnế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
inlineImagesObjectmộ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" />
nameStringtên của người gửi email (mặc định: tên của người dùng)
replyToStringđị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/

Xem thêm