Trang này được dịch bởi Cloud Translation API.

Class 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ức	Loại 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 bản 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 thư 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.

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 đượ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 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 đượ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 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 đượ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 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 đượ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 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 đượ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 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ên	Loại	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 đề email (tối đa 250 ký tự)
`body`	`String`	nộ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 đượ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 có liên quan:

https://mail.google.com/

Xem thêm

GmailApp.createDraft(recipient, subject, body)

`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ên	Loại	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 đề email (tối đa 250 ký tự)
`body`	`String`	nội dung của email
`options`	`Object`	mộ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ên	Loại	Mô tả
`attachments`	`BlobSource[]`	một آرایه tệp để gửi cùng email
`bcc`	`String`	danh sách địa chỉ email được phân tách bằng dấu phẩy để gửi bcc
`cc`	`String`	danh sách địa chỉ email được phân tách bằng dấu phẩy để thêm vào phần Cc
`from`	`String`	địa chỉ gửi email, phải là một trong các giá trị mà `GmailApp.getAliases()` trả về
`htmlBody`	`String`	nế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
`inlineImages`	`Object`	mộ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" />`
`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ậ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 đượ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 có liên quan:

https://mail.google.com/

Xem thêm

GmailApp.createDraft(recipient, subject, body, options)