Class GmailMessage

GmailMessage

Một thư 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
createDraftReply(body)	GmailDraft	Tạo thư nháp để trả lời người gửi thư này bằng địa chỉ trả lời.
createDraftReply(body, options)	GmailDraft	Tạo thư nháp để trả lời người gửi thư này bằng địa chỉ trả lời, kèm theo các đối số không bắt buộc.
createDraftReplyAll(body)	GmailDraft	Tạo một thư nháp để trả lời người gửi bằng địa chỉ trả lời và tất cả người nhận của thư này.
createDraftReplyAll(body, options)	GmailDraft	Tạo một thư nháp để trả lời người gửi thư này bằng địa chỉ trả lời và tất cả người nhận, kèm theo các đối số không bắt buộc.
forward(recipient)	GmailMessage	Chuyển tiếp thư này đến người nhận mới.
forward(recipient, options)	GmailMessage	Chuyển tiếp thư này đến người nhận mới, có thể kèm theo đối số.
getAttachments()	GmailAttachment[]	Lấy tất cả tệp đính kèm cho thư này.
getAttachments(options)	GmailAttachment[]	Lấy tất cả tệp đính kèm cho thư này.
getBcc()	String	Lấy danh sách người nhận được gửi bcc cho thư này, phân tách bằng dấu phẩy.
getBody()	String	Lấy nội dung HTML của phần nội dung thư này.
getCc()	String	Lấy danh sách người nhận được cc trong thư này, phân tách bằng dấu phẩy.
getDate()	Date	Lấy ngày và giờ của thông báo này.
getFrom()	String	Lấy người gửi của thư này.
getHeader(name)	String	Lấy giá trị của một tiêu đề RFC 2822 dựa trên tên tiêu đề.
getId()	String	Lấy mã nhận dạng của thông báo này.
getPlainBody()	String	Lấy nội dung phần nội dung của thư này mà không có định dạng HTML.
getRawContent()	String	Lấy nội dung thô của thư này.
getReplyTo()	String	Lấy địa chỉ trả lời của thư này (thường là người gửi).
getSubject()	String	Lấy tiêu đề của thư này.
getThread()	GmailThread	Lấy luồng chứa thông báo này.
getTo()	String	Lấy danh sách người nhận được phân tách bằng dấu phẩy của thư này.
isDraft()	Boolean	Lấy thông tin về việc thư này có phải là thư nháp hay không.
isInChats()	Boolean	Cho biết liệu thông báo này có phải là một cuộc trò chuyện hay không.
isInInbox()	Boolean	Cho biết thư này có nằm trong hộp thư đến hay không.
isInPriorityInbox()	Boolean	Trả về true nếu thư này nằm trong hộp thư đến ưu tiên; trả về false nếu không.
isInTrash()	Boolean	Cho biết thư này có nằm trong thùng rác hay không.
isStarred()	Boolean	Cho biết tin nhắn này có được gắn dấu sao hay không.
isUnread()	Boolean	Cho biết liệu thư này chưa đọc hay chưa.
markRead()	GmailMessage	Đánh dấu thư là đã đọc.
markUnread()	GmailMessage	Đánh dấu thư là chưa đọc.
moveToTrash()	GmailMessage	Di chuyển thư vào thùng rác.
refresh()	GmailMessage	Tải lại thư này và trạng thái liên kết từ Gmail (hữu ích trong trường hợp nhãn, trạng thái đã đọc, v.v. đã thay đổi).
reply(body)	GmailMessage	Trả lời người gửi thư này bằng địa chỉ trả lời.
reply(body, options)	GmailMessage	Trả lời người gửi thư này bằng địa chỉ trả lời, kèm theo các đối số không bắt buộc.
replyAll(body)	GmailMessage	Trả lời người gửi bằng địa chỉ trả lời và tất cả người nhận của thư này.
replyAll(body, options)	GmailMessage	Trả lời người gửi thư này bằng địa chỉ trả lời và tất cả người nhận, với các đối số không bắt buộc.
star()	GmailMessage	Gắn dấu sao cho tin nhắn.
unstar()	GmailMessage	Bỏ gắn dấu sao cho tin nhắn.

Tài liệu chi tiết

createDraftReply(body)

Tạo thư nháp để trả lời người gửi thư này bằng địa chỉ trả lời. Kích thước của email (bao gồm cả tiêu đề) bị giới hạn về hạn mức.

// Create a draft reply to the original message with an acknowledgment.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReply('Got your message');

Tham số

Tên	Loại	Mô tả
body	String	Nội dung của email.

Cầu thủ trả bóng

GmailDraft – Thư nháp mới tạo.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần đượ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

• reply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

---

createDraftReply(body, options)

Tạo thư nháp để trả lời người gửi thư này bằng địa chỉ trả lời, kèm theo các đối số không bắt buộc.

Email có thể chứa cả văn bản thuần tuý và nội dung HTML. Kích thước của email (bao gồm cả tiêu đề) đã vượt quá hạn mức.

// Create a draft response with an HTML text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReply('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: '[e-mail]',
});

Tham số

Tên	Loại	Mô 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 mảng các 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ỉ mà email sẽ được gửi từ đó, phải là một trong các giá trị do GmailApp.getAliases() trả về
htmlBody	String	khi được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng tham số này thay vì đối số body bắt buộc; bạn có thể thêm trường inlineImages không bắt buộc vào phần nội dung HTML nếu có hình ảnh nội tuyến cho email
inlineImages	Object	một đối tượng JavaScript chứa một mối 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 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" />
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)
subject	String	Dòng tiêu đề mới cho email, tối đa 250 ký tự.

Cầu thủ trả bóng

GmailDraft – Thư nháp mới tạo.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần đượ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

• reply(body, options)
• createDraftReply(body)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

---

createDraftReplyAll(body)

Tạo một thư nháp để trả lời người gửi bằng địa chỉ trả lời và tất cả người nhận của thư này. Kích thước của email (bao gồm cả phần đầu thư) đã vượt quá hạn mức.

// Create a draft response to all recipients (except those bcc'd) with an
// acknowledgment.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReplyAll('Got your message');

Tham số

Tên	Loại	Mô tả
body	String	Nội dung của email.

Cầu thủ trả bóng

GmailDraft – Thư nháp mới tạo.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần đượ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

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body, options)

---

createDraftReplyAll(body, options)

Tạo một thư nháp để trả lời người gửi thư này bằng địa chỉ trả lời và tất cả người nhận, kèm theo các đối số không bắt buộc.

Email có thể chứa cả văn bản thuần tuý và nội dung HTML. Kích thước của email (bao gồm cả tiêu đề) đã vượt quá hạn mức.

// Create a draft response to all recipients (except those bcc'd) using an HTML
// text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReplyAll('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: '[e-mail]',
});

Tham số

Tên	Loại	Mô 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 mảng các 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ỉ mà email sẽ được gửi từ đó, phải là một trong các giá trị do GmailApp.getAliases() trả về
htmlBody	String	khi được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng tham số này thay vì đối số body bắt buộc; bạn có thể thêm trường inlineImages không bắt buộc vào phần nội dung HTML nếu có hình ảnh nội tuyến cho email
inlineImages	Object	một đối tượng JavaScript chứa một mối 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 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" />
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)
subject	String	Dòng tiêu đề mới cho email, tối đa 250 ký tự.

Cầu thủ trả bóng

GmailDraft – Thư nháp mới tạo.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần đượ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

• replyAll(body, options)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)

---

forward(recipient)

Chuyển tiếp thư này đến người nhận mới. Kích thước của email (bao gồm cả phần đầu thư) đã vượt quá hạn mức.

// Forward first message of first inbox thread to recipient1 & recipient2,
// both @example.com
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.forward('[e-mail],[e-mail]');

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.

Cầu thủ trả bóng

GmailMessage – Thông báo này hữu ích cho việc liên kế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 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

• forward(recipient, options)

---

forward(recipient, options)

Chuyển tiếp thư này đến người nhận mới, có thể kèm theo đối số.

Email có thể chứa cả văn bản thuần tuý và nội dung HTML. Kích thước của email (bao gồm cả phần đầu thư) là hạn mức.

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.forward('[e-mail],[e-mail]', {
  cc: '[e-mail]',
  bcc: '[e-mail],[e-mail]',
});

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.
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 mảng các 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ỉ mà email sẽ được gửi từ đó, phải là một trong các giá trị do GmailApp.getAliases() trả về
htmlBody	String	khi được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng tham số này thay vì đối số body bắt buộc; bạn có thể thêm trường inlineImages không bắt buộc vào phần nội dung HTML nếu có hình ảnh nội tuyến cho email
inlineImages	Object	một đối tượng JavaScript chứa một mối 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 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" />
name	String	tên của người gửi email (mặc định: tên của người dùng)
noReply	Boolean	true nếu email được gửi từ một địa chỉ email chung không dùng để trả lời nhằm ngăn người nhận trả lời email; lựa chọn này chỉ dành cho tài khoản Google Workspace, không dành cho người dùng Gmail
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)
subject	String	Dòng tiêu đề mới cho email, tối đa 250 ký tự.

Cầu thủ trả bóng

GmailMessage – Thông báo này hữu ích cho việc liên kế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 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

• forward(recipient)

---

getAttachments()

Lấy tất cả tệp đính kèm cho thư này.

Cầu thủ trả bóng

GmailAttachment[] – Một mảng gồm các tệp đính kèm Blob cho thư 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 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/

---

getAttachments(options)

Lấy tất cả tệp đính kèm cho thư này.

Tham số

Tên	Loại	Mô tả
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ả
includeInlineImages	Boolean	true nếu mảng Blob đính kèm được trả về phải bao gồm hình ảnh cùng dòng (mặc định là true).
includeAttachments	Boolean	true nếu mảng Blob đính kèm được trả về phải bao gồm các tệp đính kèm thông thường (không phải nội tuyến) (mặc định là true).

Cầu thủ trả bóng

GmailAttachment[] – Một mảng gồm các tệp đính kèm Blob cho thư 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 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/

---

getBcc()

Lấy danh sách người nhận được gửi bcc cho thư này, phân tách bằng dấu phẩy.

Theo định nghĩa, trường này sẽ trống đối với tất cả thư đã nhận.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getBcc());                      // Log bcc'd addresses

Cầu thủ trả bóng

String – Danh sách người nhận được gửi ở chế độ bcc cho thư này, phân tách bằng dấu phẩ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 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

• getTo()

---

getBody()

Lấy nội dung HTML của phần nội dung thư này.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getBody());                     // Log contents of the body

Cầu thủ trả bóng

String – Nội dung của thư 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 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

• getSubject()

---

getCc()

Lấy danh sách người nhận được cc trong thư này, phân tách bằng dấu phẩy.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getCc());                       // Log cc'd addresses

Cầu thủ trả bóng

String – Danh sách người nhận được cc trong thư này, phân tách bằng dấu phẩ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 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

• getTo()

---

getDate()

Lấy ngày và giờ của thông báo này.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getDate());  // Log date and time of the message

Cầu thủ trả bóng

Date – Ngày và giờ của thông báo 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 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/

---

getFrom()

Lấy người gửi của thư này.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getFrom());  // Log from address of the message

Cầu thủ trả bóng

String – Địa chỉ email của người gửi 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 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

• getReplyTo()

---

getHeader(name)

Lấy giá trị của một tiêu đề RFC 2822 dựa trên tên tiêu đề.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox.
const message = thread.getMessages()[0];           // Get the first message.
Logger.log(
    message.getHeader('Message-ID'));  // Logs the Message-ID RFC 2822 header.

Tham số

Tên	Loại	Mô tả
name	String	Tên của tiêu đề RFC, không có dấu hai chấm phân tách tên đó với giá trị.

Cầu thủ trả bóng

String – Giá trị của tiêu đề hoặc một chuỗi trống nếu tiêu đề không có trong thông báo.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần đượ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ông báo này.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
const id = message.getId();
const messageById = GmailApp.getMessageById(id);
Logger.log(
    message.getSubject() === messageById.getMessage());  // Always logs true

Cầu thủ trả bóng

String – Mã nhận dạng thư.

---

getPlainBody()

Lấy nội dung phần nội dung của thư này mà không có định dạng HTML. Quá trình này phức tạp hơn getBody() và mất nhiều thời gian hơn.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getPlainBody());                // Log contents of the body

Cầu thủ trả bóng

String – Nội dung thư thuần tuý của thư 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 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

• getSubject()

---

getRawContent()

Lấy nội dung thô của thư này. Thao tác này tương đương với thao tác "Hiển thị thư gốc" trong giao diện người dùng Gmail.

Cầu thủ trả bóng

String – Nội dung thô của thư 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 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/

---

getReplyTo()

Lấy địa chỉ trả lời của thư này (thường là người gửi).

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getReplyTo());                  // Logs reply-to address

Cầu thủ trả bóng

String – Địa chỉ email nhận thư trả lờ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 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

• getCc()

---

getSubject()

Lấy tiêu đề của thư này.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getSubject());                  // Log subject line

Cầu thủ trả bóng

String – Tiêu đề của thư 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 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

• getAttachments()

---

getThread()

Lấy luồng chứa thông báo này.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(
    message.getThread().getFirstMessageSubject() ===
        thread.getFirstMessageSubject(),
);  // Always logs true

Cầu thủ trả bóng

GmailThread – GmailThread chứa thư 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 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/

---

getTo()

Lấy danh sách người nhận được phân tách bằng dấu phẩy của thư này.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(message.getTo());  // Log the recipient of message

Cầu thủ trả bóng

String – Danh sách người nhận được phân tách bằng dấu phẩy của thư 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 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

• getCc()

---

isDraft()

Lấy thông tin về việc thư này có phải là thư nháp hay không.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is draft? ${message.isDraft()}`);

Cầu thủ trả bóng

Boolean – Thư này có phải là thư nháp hay không.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần đượ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/

---

isInChats()

Cho biết liệu thông báo này có phải là một cuộc trò chuyện hay không.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is a chat? ${message.isInChats()}`);

Cầu thủ trả bóng

Boolean – Tin nhắn này có phải là tin nhắn trò chuyện hay không.

---

isInInbox()

Cho biết thư này có nằm trong hộp thư đến hay không.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is in inbox? ${message.isInInbox()}`);

Cầu thủ trả bóng

Boolean – Thư này có nằm trong hộp thư đến hay không.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần đượ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/

---

isInPriorityInbox()

Trả về true nếu thư này nằm trong hộp thư đến ưu tiên; trả về false nếu không.

const thread = GmailApp.getPriorityInboxThreads(
    0, 1)[0];  // Get first thread in priority inbox
const messages = thread.getMessages();
for (let i = 0; i < messages.length; i++) {
  // At least one of the messages is in priority inbox
  Logger.log(`is in priority inbox? ${messages[i].isInPriorityInbox()}`);
}

Cầu thủ trả bóng

Boolean – Thông báo này có nằm trong hộp thư ưu tiên hay không.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần đượ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/

---

isInTrash()

Cho biết thư này có nằm trong thùng rác hay không.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is in the trash? ${message.isInTrash()}`);

Cầu thủ trả bóng

Boolean – Thư này có nằm trong thùng rác hay không.

---

isStarred()

Cho biết tin nhắn này có được gắn dấu sao hay không.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is starred? ${message.isStarred()}`);

Cầu thủ trả bóng

Boolean – Tin nhắn này có được gắn dấu sao hay không.

---

isUnread()

Cho biết liệu thư này chưa đọc hay chưa.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is unread? ${message.isUnread()}`);

Cầu thủ trả bóng

Boolean – Trạng thái chưa đọc của thư 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 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/

---

markRead()

Đánh dấu thư là đã đọc.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
message.markRead();                                // Mark as read

Cầu thủ trả bóng

GmailMessage – GmailMessage này rất hữu ích cho việc liên kế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 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

• isUnread()

---

markUnread()

Đánh dấu thư là chưa đọc.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
message.markUnread();                              // Mark as unread

Cầu thủ trả bóng

GmailMessage – GmailMessage này rất hữu ích cho việc liên kế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 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

• isUnread()

---

moveToTrash()

Di chuyển thư vào thùng rác.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
message.moveToTrash();                             // Move message to trash

Cầu thủ trả bóng

GmailMessage – GmailMessage này rất hữu ích cho việc liên kế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 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

• isInTrash()

---

refresh()

Tải lại thư này và trạng thái liên kết từ Gmail (hữu ích trong trường hợp nhãn, trạng thái đã đọc, v.v. đã thay đổi).

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
// .. Do bunch of stuff here
message.refresh();  // Make sure it's up to date
// Do more stuff to message

Cầu thủ trả bóng

GmailMessage – Thông báo này dùng để liên kế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 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/

---

reply(body)

Trả lời người gửi thư này bằng địa chỉ trả lời. Kích thước của email (bao gồm cả phần đầu thư) là hạn mức.

// Respond to author of message with acknowledgment
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.reply('Got your message');

Tham số

Tên	Loại	Mô tả
body	String	Nội dung của email.

Cầu thủ trả bóng

GmailMessage – Thông báo này hữu ích cho việc liên kế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 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

• reply(body, options)
• replyAll(body)
• replyAll(body, options)

---

reply(body, options)

Trả lời người gửi thư này bằng địa chỉ trả lời, kèm theo các đối số không bắt buộc.

Email có thể chứa cả văn bản thuần tuý và nội dung HTML. Kích thước của email (bao gồm cả phần đầu thư) là hạn mức.

// Respond with HTML body text
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.reply('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  noReply: true,
});

Tham số

Tên	Loại	Mô 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 mảng các 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ỉ mà email sẽ được gửi từ đó, phải là một trong các giá trị do GmailApp.getAliases() trả về
htmlBody	String	khi được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng tham số này thay vì đối số body bắt buộc; bạn có thể thêm trường inlineImages không bắt buộc vào phần nội dung HTML nếu có hình ảnh nội tuyến cho email
inlineImages	Object	một đối tượng JavaScript chứa một mối 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 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" />
name	String	tên của người gửi email (mặc định: tên của người dùng)
noReply	Boolean	true nếu email được gửi từ một địa chỉ email chung không dùng để trả lời nhằm ngăn người nhận trả lời email; lựa chọn này chỉ dành cho tài khoản Google Workspace, không dành cho người dùng Gmail
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)
subject	String	Dòng tiêu đề mới cho email, tối đa 250 ký tự.

Cầu thủ trả bóng

GmailMessage – Thông báo này hữu ích cho việc liên kế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 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

• reply(body)
• replyAll(body)
• replyAll(body, options)

---

replyAll(body)

Trả lời người gửi bằng địa chỉ trả lời và tất cả người nhận của thư này. Kích thước của email (bao gồm cả phần đầu thư) bị giới hạn về hạn mức.

// Respond to all recipients (except bcc'd) of last email in thread with
// acknowledgment
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.replyAll('Got your message');

Tham số

Tên	Loại	Mô tả
body	String	Nội dung của email.

Cầu thủ trả bóng

GmailMessage – Thông báo này hữu ích cho việc liên kế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 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

• reply(body)
• reply(body, options)
• replyAll(body, options)

---

replyAll(body, options)

Trả lời người gửi thư này bằng địa chỉ trả lời và tất cả người nhận, với các đối số không bắt buộc.

Email có thể chứa cả văn bản thuần tuý và nội dung HTML. Kích thước của email (bao gồm cả phần đầu thư) là hạn mức.

// Respond with HTML body text
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.replyAll('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  noReply: true,
});

Tham số

Tên	Loại	Mô 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 mảng các 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ỉ mà email sẽ được gửi từ đó, phải là một trong các giá trị do GmailApp.getAliases() trả về
htmlBody	String	khi được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng tham số này thay vì đối số body bắt buộc; bạn có thể thêm trường inlineImages không bắt buộc vào phần nội dung HTML nếu có hình ảnh nội tuyến cho email
inlineImages	Object	một đối tượng JavaScript chứa một mối 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 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" />
name	String	tên của người gửi email (mặc định: tên của người dùng)
noReply	Boolean	true nếu email được gửi từ một địa chỉ email chung không dùng để trả lời nhằm ngăn người nhận trả lời email; lựa chọn này chỉ dành cho tài khoản Google Workspace, không dành cho người dùng Gmail
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)
subject	String	Dòng tiêu đề mới cho email, tối đa 250 ký tự.

Cầu thủ trả bóng

GmailMessage – Thông báo này hữu ích cho việc liên kế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 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

• reply(body)
• reply(body, options)
• replyAll(body)

---

star()

Gắn dấu sao cho tin nhắn.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
message.star();                                    // Star the message

Cầu thủ trả bóng

GmailMessage – GmailMessage này rất hữu ích cho việc liên kế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 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

• unstar()

---

unstar()

Bỏ gắn dấu sao cho tin nhắn.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
message.unstar();                                  // Unstar the message

Cầu thủ trả bóng

GmailMessage – GmailMessage này rất hữu ích cho việc liên kế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 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

• star()