Class GmailDraft

GmailBản nháp

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ứcLoại 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 bản 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 thư 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. 

const 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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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. 

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const draftId = draft.getId();
const draftById = GmailApp.getDraft(draftId);
Logger.log(
    draft.getMessage().getSubject() === draftById.getMessage().getSubject(),
);

Cầu thủ trả bóng

String – mã nhận dạng bản nháp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

  • https://mail.google.com/

getMessage()

Trả về một GmailMessage đại diện cho bản nháp này. 

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const 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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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. 

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const messageId = draft.getMessageId();
Logger.log(messageId === draft.getMessage().getId());

Cầu thủ trả bóng

String – mã nhận dạng thư

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

  • https://mail.google.com/

send()

Gửi thư email nháp này. Kích thước của email (bao gồm cả tiêu đề) bị giới hạn theo hạn mức. 

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const 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 gửi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 đề) bị giới hạn theo hạn mức. 

// The code below will update a draft email with the current date and time.
const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const now = new Date();
draft.update(
    'mike@example.com',
    'current time',
    `The time is: ${now.toString()}`,
);

Tham số

TênLoạiMô tả
recipientStringdanh sách địa chỉ email được phân tách bằng dấu phẩy
subjectStringtiêu đề email (tối đa 250 ký tự)
bodyStringnội dung của email

Cầu thủ trả bóng

GmailDraft – bản nháp mới cập nhật

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp 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 đề) bị giới hạn theo hạn mức. 

// Update a draft email with a file from Google Drive attached as a PDF.
const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
draft.update(
    'mike@example.com',
    'Attachment example',
    'Please see attached file.',
    {
      attachments: [file.getAs(MimeType.PDF)],
      name: 'Automatic Emailer Script',
    },
);

Tham số

TênLoạiMô tả
recipientStringdanh sách địa chỉ email được phân tách bằng dấu phẩy
subjectStringtiêu đề email (tối đa 250 ký tự)
bodyStringnội dung của email
optionsObjectmột đố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ênLoạiMô tả
attachmentsBlobSource[]một آرایه tệp để gửi cùng email
bccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để gửi bcc
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để thêm vào phần Cc
fromStringđịa chỉ gửi email, phải là một trong các giá trị mà GmailApp.getAliases() trả về
htmlBodyStringnếu được đặt, các thiết bị có thể hiển thị HTML sẽ sử dụng trường 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 đã thêm hình ảnh nội tuyến cho email
inlineImagesObjectmột đối tượng JavaScript chứa mối liên kết từ khoá hình ảnh (String) đến dữ liệu hình ảnh (BlobSource); giả định rằng tham số htmlBody được sử dụng và chứa các tệp tham chiếu đến các 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ập nhật

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm