Class GmailDraft

GmailDraft

Tin nhắn 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á tin nhắn nháp này.
getId()StringLấy mã của tin nhắn nháp này.
getMessage()GmailMessageTrả về GmailMessage đại diện cho bản nháp này.
getMessageId()StringTrả về mã của GmailMessage đại diện cho bản nháp này.
send()GmailMessageGửi nội dung email nháp này.
update(recipient, subject, body)GmailDraftThay thế nội dung của tin nhắn nháp này.
update(recipient, subject, body, options)GmailDraftThay thế nội dung của tin nhắn 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á tin nhắn 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

Tập lệnh sử dụng phương thức này yêu cầu được 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 liên quan:

  • https://mail.google.com/

getId()

Lấy mã của tin nhắn 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ã bản nháp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu được 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 liên quan:

  • https://mail.google.com/

getMessage()

Trả về 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 – tin nhắn đại diện cho nội dung của bản nháp này

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu được 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 liên quan:

  • https://mail.google.com/

getMessageId()

Trả về mã 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ã tin nhắn

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu được 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 liên quan:

  • https://mail.google.com/

send()

Gửi nội dung 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

Tập lệnh sử dụng phương thức này yêu cầu được 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 liên quan:

  • https://mail.google.com/

update(recipient, subject, body)

Thay thế nội dung của tin nhắn 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 đề 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ập nhật

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu được 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 liên quan:

  • https://mail.google.com/

Xem thêm

update(recipient, subject, body, options)

Thay thế nội dung của tin nhắn 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 đề 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ê bên dưới

Thông số nâng cao

TênLoạiMô tả
attachmentsBlobSource[]một mảng các tệp để gửi cùng với email
bccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để BCC
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để cc
fromStringđịa chỉ mà email sẽ được gửi từ đó, phải là một trong các giá trị do 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 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 vào nội dung HTML nếu bạn có hình ảnh nội tuyến cho email
inlineImagesObjectđối tượng JavaScript chứa một bản đồ 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 các 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ập nhật

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu được 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 liên quan:

  • https://mail.google.com/

Xem thêm