Gmail Service

Gmail

Dịch vụ này cho phép bạn gửi email, soạn thư nháp, quản lý nhãn, đánh dấu thư và chuỗi thư, cũng như thực hiện nhiều thao tác quản lý tài khoản Gmail khác. Xem thêm Dịch vụ thư, một dịch vụ đơn giản hơn chỉ cho phép gửi email.

Lớp

Tên	Mô tả ngắn
GmailApp	Cho phép truy cập vào các chuỗi thư, thư và nhãn trong Gmail.
GmailAttachment	Tệp đính kèm trong Gmail.
GmailDraft	Thư nháp do người dùng tạo trong tài khoản Gmail của người dùng.
GmailLabel	Nhãn do người dùng tạo trong tài khoản Gmail của người dùng.
GmailMessage	Thư trong tài khoản Gmail của người dùng.
GmailThread	Một chuỗi thư trong tài khoản Gmail của người dùng.

GmailApp

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
createDraft(recipient, subject, body)	GmailDraft	Tạo thư email nháp.
createDraft(recipient, subject, body, options)	GmailDraft	Tạo một thư email nháp có các đối số không bắt buộc.
createLabel(name)	GmailLabel	Tạo một nhãn người dùng mới có tên đã cho.
deleteLabel(label)	GmailApp	Xoá nhãn đã chỉ định.
getAliases()	String[]	Lấy danh sách email được thiết lập làm bí danh cho tài khoản này trong Gmail.
getDraft(draftId)	GmailDraft	Truy xuất thư nháp theo mã nhận dạng.
getDraftMessages()	GmailMessage[]	Truy xuất tất cả thư nháp.
getDrafts()	GmailDraft[]	Lấy tất cả thư nháp trong Gmail.
getInboxThreads()	GmailThread[]	Truy xuất tất cả chuỗi thư trong Hộp thư đến, bất kể nhãn.
getInboxThreads(start, max)	GmailThread[]	Truy xuất một dải chuỗi thư trong Hộp thư đến, bất kể nhãn.
getInboxUnreadCount()	Integer	Lấy số lượng chuỗi tin nhắn chưa đọc trong hộp thư đến.
getMessageById(id)	GmailMessage	Lấy thông báo theo mã nhận dạng.
getMessagesForThread(thread)	GmailMessage[]	Truy xuất tất cả thư trong chuỗi thư đã chỉ định.
getMessagesForThreads(threads)	GmailMessage[][]	Truy xuất tất cả thư trong các chuỗi thư đã chỉ định.
getPriorityInboxThreads()	GmailThread[]	Truy xuất tất cả chuỗi thư trong Hộp thư đến ưu tiên, bất kể nhãn.
getPriorityInboxThreads(start, max)	GmailThread[]	Truy xuất một loạt chuỗi thư trong Hộp thư ưu tiên, bất kể nhãn.
getPriorityInboxUnreadCount()	Integer	Lấy số lượng chuỗi thư chưa đọc trong Hộp thư ưu tiên.
getSpamThreads()	GmailThread[]	Truy xuất tất cả chuỗi thư rác bất kể nhãn.
getSpamThreads(start, max)	GmailThread[]	Truy xuất một loạt chuỗi thư rác bất kể nhãn.
getSpamUnreadCount()	Integer	Lấy số lượng chuỗi tin nhắn chưa đọc là thư rác.
getStarredThreads()	GmailThread[]	Truy xuất tất cả chuỗi tin nhắn được gắn dấu sao, bất kể nhãn.
getStarredThreads(start, max)	GmailThread[]	Truy xuất một loạt chuỗi tin nhắn được gắn dấu sao, bất kể nhãn.
getStarredUnreadCount()	Integer	Lấy số lượng chuỗi tin nhắn chưa đọc được gắn dấu sao.
getThreadById(id)	GmailThread	Lấy luồng theo mã nhận dạng.
getTrashThreads()	GmailThread[]	Truy xuất tất cả chuỗi thư rác bất kể nhãn.
getTrashThreads(start, max)	GmailThread[]	Truy xuất một loạt chuỗi thư rác bất kể nhãn.
getUserLabelByName(name)	GmailLabel	Truy xuất một nhãn dựa trên tên nhãn.
getUserLabels()	GmailLabel[]	Truy xuất danh sách nhãn do người dùng tạo.
markMessageRead(message)	GmailApp	Đánh dấu tin nhắn này là đã đọc và buộc làm mới tin nhắn.
markMessageUnread(message)	GmailApp	Đánh dấu tin nhắn này là chưa đọc và buộc làm mới tin nhắn.
markMessagesRead(messages)	GmailApp	Đánh dấu các thư này là đã đọc và buộc làm mới các thư.
markMessagesUnread(messages)	GmailApp	Đánh dấu những thư này là chưa đọc và buộc thư làm mới.
markThreadImportant(thread)	GmailApp	Đánh dấu luồng này là quan trọng và buộc luồng làm mới.
markThreadRead(thread)	GmailApp	Đánh dấu chuỗi tin nhắn này là đã đọc và buộc chuỗi tin nhắn làm mới.
markThreadUnimportant(thread)	GmailApp	Đánh dấu chuỗi tin nhắn này là không quan trọng và buộc chuỗi tin nhắn làm mới.
markThreadUnread(thread)	GmailApp	Đánh dấu chuỗi tin nhắn này là chưa đọc và buộc chuỗi tin nhắn làm mới.
markThreadsImportant(threads)	GmailApp	Đánh dấu các luồng này là quan trọng và buộc các luồng làm mới.
markThreadsRead(threads)	GmailApp	Đánh dấu các chuỗi tin nhắn này là đã đọc và buộc các chuỗi tin nhắn làm mới.
markThreadsUnimportant(threads)	GmailApp	Đánh dấu các luồng này là không quan trọng và buộc các luồng này làm mới.
markThreadsUnread(threads)	GmailApp	Đánh dấu các chuỗi tin nhắn này là chưa đọc và buộc các chuỗi tin nhắn làm mới.
moveMessageToTrash(message)	GmailApp	Di chuyển thư vào thùng rác và buộc thư làm mới.
moveMessagesToTrash(messages)	GmailApp	Di chuyển các thư đã chỉ định vào thùng rác và buộc các thư đó làm mới.
moveThreadToArchive(thread)	GmailApp	Di chuyển chuỗi tin nhắn này vào kho lưu trữ và buộc chuỗi tin nhắn làm mới.
moveThreadToInbox(thread)	GmailApp	Di chuyển chuỗi thư này vào hộp thư đến và buộc chuỗi thư làm mới.
moveThreadToSpam(thread)	GmailApp	Di chuyển chuỗi thư này sang thư rác và buộc chuỗi thư làm mới.
moveThreadToTrash(thread)	GmailApp	Di chuyển chuỗi tin nhắn này vào thùng rác và buộc chuỗi tin nhắn làm mới.
moveThreadsToArchive(threads)	GmailApp	Di chuyển các luồng này vào bản lưu trữ và buộc các luồng làm mới.
moveThreadsToInbox(threads)	GmailApp	Di chuyển các chuỗi thư này vào hộp thư đến và buộc các chuỗi thư làm mới.
moveThreadsToSpam(threads)	GmailApp	Di chuyển các chuỗi tin nhắn này sang phần nội dung rác và buộc các chuỗi tin nhắn đó làm mới.
moveThreadsToTrash(threads)	GmailApp	Di chuyển các luồng này vào thùng rác và buộc các luồng này làm mới.
refreshMessage(message)	GmailApp	Tải lại thư và trạng thái liên kết từ Gmail (rất hữu ích trong trường hợp nhãn, trạng thái đã đọc, v.v. đã thay đổi).
refreshMessages(messages)	GmailApp	Tải lại thư và trạng thái liên kết từ Gmail (rất hữu ích trong trường hợp nhãn, trạng thái đã đọc, v.v. đã thay đổi).
refreshThread(thread)	GmailApp	Tải lại luồng và trạng thái liên kết từ Gmail (rất hữu ích trong trường hợp nhãn, trạng thái đã đọc, v.v. đã thay đổi).
refreshThreads(threads)	GmailApp	Tải lại các chuỗi thư và trạng thái liên kết từ Gmail (rất hữu ích trong trường hợp các nhãn, trạng thái đã đọc, v.v. đã thay đổi).
search(query)	GmailThread[]	Tìm kiếm trong Gmail bằng cụm từ tìm kiếm đã cho.
search(query, start, max)	GmailThread[]	Tìm kiếm trong Gmail bằng cụm từ tìm kiếm đã cho.
sendEmail(recipient, subject, body)	GmailApp	Gửi email.
sendEmail(recipient, subject, body, options)	GmailApp	Gửi email có đối số tuỳ chọn.
setCurrentMessageAccessToken(accessToken)	void	Đặt mã thông báo truy cập hiện tại cho phép tập lệnh truy cập vào các thuộc tính GmailMessage hiện tại.
starMessage(message)	GmailApp	Thêm dấu sao vào thư này và buộc thư làm mới.
starMessages(messages)	GmailApp	Thêm dấu sao vào các thư này và buộc thư làm mới.
unstarMessage(message)	GmailApp	Xoá dấu sao khỏi thư này và buộc thư làm mới.
unstarMessages(messages)	GmailApp	Xoá dấu sao khỏi các thư này và buộc thư làm mới.

GmailAttachment

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
copyBlob()	Blob	Trả về một bản sao của blob này.
getAs(contentType)	Blob	Trả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi thành loại nội dung đã chỉ định.
getBytes()	Byte[]	Lấy dữ liệu được lưu trữ trong blob này.
getContentType()	String	Lấy loại nội dung của các byte trong blob này.
getDataAsString()	String	Lấy dữ liệu của blob này dưới dạng Chuỗi có bộ mã hoá UTF-8.
getDataAsString(charset)	String	Lấy dữ liệu của blob này dưới dạng chuỗi có mã hoá được chỉ định.
getHash()	String	Lấy hàm băm nội dung SHA1 cho tệp đính kèm này.
getName()	String	Lấy tên của blob này.
getSize()	Integer	Lấy kích thước của tệp đính kèm này.
isGoogleType()	Boolean	Trả về kết quả cho biết liệu blob này có phải là tệp Google Workspace (Trang tính, Tài liệu, v.v.) hay không.
setBytes(data)	Blob	Đặt dữ liệu được lưu trữ trong blob này.
setContentType(contentType)	Blob	Đặt loại nội dung của các byte trong blob này.
setContentTypeFromExtension()	Blob	Đặt loại nội dung của các byte trong blob này dựa trên đuôi tệp.
setDataFromString(string)	Blob	Đặt dữ liệu của blob này từ một chuỗi có bộ mã hoá UTF-8.
setDataFromString(string, charset)	Blob	Đặt dữ liệu của blob này từ một chuỗi có mã hoá được chỉ định.
setName(name)	Blob	Đặt tên cho blob này.

GmailDraft

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.

GmailLabel

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
addToThread(thread)	GmailLabel	Thêm nhãn này vào luồng đã cho và buộc luồng làm mới (GmailThread.refresh()).
addToThreads(threads)	GmailLabel	Thêm nhãn này vào các luồng đã cho và buộc các luồng đó làm mới.
deleteLabel()	void	Xoá nhãn này.
getName()	String	Lấy tên của nhãn này.
getThreads()	GmailThread[]	Lấy các luồng được đánh dấu bằng nhãn này.
getThreads(start, max)	GmailThread[]	Lấy một dải luồng được đánh dấu bằng nhãn này.
getUnreadCount()	Integer	Lấy số lượng chuỗi tin nhắn chưa đọc được gắn thẻ này.
removeFromThread(thread)	GmailLabel	Xoá nhãn này khỏi luồng đã cho và buộc luồng làm mới.
removeFromThreads(threads)	GmailLabel	Xoá nhãn này khỏi các luồng đã cho và buộc các luồng làm mới.

GmailMessage

Phương thức

Phương thức	Loại 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, với các đối số không bắt buộc.
createDraftReplyAll(body)	GmailDraft	Tạo 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 thư này.
createDraftReplyAll(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 và tất cả người nhận, với 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, với các đối số không bắt buộc.
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 những người nhận được bcc được phân tách bằng dấu phẩy trên thư này.
getBody()	String	Lấy nội dung HTML của phần nội dung thư này.
getCc()	String	Lấy những người nhận được cc được phân tách bằng dấu phẩy trên thư nà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 thư này.
getHeader(name)	String	Lấy giá trị của tiêu đề RFC 2822 theo tên tiêu đề.
getId()	String	Lấy mã nhận dạng của thư này.
getPlainBody()	String	Lấy nội dung của phần nội dung thư này mà không đị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 chuỗi chứa thông báo này.
getTo()	String	Lấy người nhận được phân tách bằng dấu phẩy của thư này.
isDraft()	Boolean	Xác định xem thư này có phải là thư nháp hay không.
isInChats()	Boolean	Xem liệu tin nhắn này có phải là tin nhắn trò chuyện hay không.
isInInbox()	Boolean	Xem thư này có trong hộp thư đến hay không.
isInPriorityInbox()	Boolean	Trả về true nếu thư này nằm trong hộp thư ưu tiên; trả về false nếu không.
isInTrash()	Boolean	Xem thư này có nằm trong thùng rác hay không.
isStarred()	Boolean	Xem tin nhắn này có được gắn dấu sao hay không.
isUnread()	Boolean	Xem tin nhắn này có phải là chưa đọc hay không.
markRead()	GmailMessage	Đánh dấu thư là đã đọc.
markUnread()	GmailMessage	Đánh dấu thư là chưa đọc.
moveToTrash()	GmailMessage	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 quan từ Gmail (rất 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, với 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 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 thư.
unstar()	GmailMessage	Bỏ gắn dấu sao cho tin nhắn.

GmailThread

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
addLabel(label)	GmailThread	Thêm nhãn này vào chuỗi tin nhắn.
createDraftReply(body)	GmailDraft	Tạo một thư nháp trả lời người gửi thư cuối cùng trong chuỗi thư này bằng địa chỉ trả lời.
createDraftReply(body, options)	GmailDraft	Tạo một thư nháp trả lời người gửi thư cuối cùng trong chuỗi thư này bằng địa chỉ trả lời, với 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 thư gần nhất trong chuỗi thư này, sử dụng địa chỉ trả lời và tất cả người nhận thư này.
createDraftReplyAll(body, options)	GmailDraft	Tạo một thư nháp trả lời người gửi thư cuối cùng trong chuỗi thư này, sử dụ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.
getFirstMessageSubject()	String	Lấy tiêu đề của thư đầu tiên trong chuỗi thư.
getId()	String	Lấy mã của luồng này.
getLabels()	GmailLabel[]	Trả về các nhãn do người dùng tạo trên chuỗi tin nhắn này.
getLastMessageDate()	Date	Lấy ngày của thư gần đây nhất trong chuỗi thư này.
getMessageCount()	Integer	Trả về số lượng tin nhắn trong chuỗi tin nhắn.
getMessages()	GmailMessage[]	Lấy các thư trong chuỗi thư này.
getPermalink()	String	Lấy đường liên kết cố định cho chuỗi tin nhắn này.
hasStarredMessages()	Boolean	Trả về thông tin về việc chuỗi tin nhắn có tin nhắn nào được gắn dấu sao hay không.
isImportant()	Boolean	Trả về thông tin về việc chuỗi tin nhắn có được đánh dấu là quan trọng hay không.
isInChats()	Boolean	Trả về thông tin về việc chuỗi tin nhắn có được gắn nhãn là cuộc trò chuyện hay không.
isInInbox()	Boolean	Trả về thông tin về việc chuỗi thư có nằm trong hộp thư đến hay không.
isInPriorityInbox()	Boolean	Trả về true nếu chuỗi thư này nằm trong hộp thư ưu tiên; trả về false nếu không.
isInSpam()	Boolean	Trả về thông tin về việc chuỗi tin nhắn có bị đánh dấu là nội dung rác hay không.
isInTrash()	Boolean	Trả về thông tin về việc chuỗi tin nhắn có nằm trong thùng rác hay không.
isUnread()	Boolean	Trả về thông tin về việc chuỗi tin nhắn có thư chưa đọc hay không.
markImportant()	GmailThread	Đánh dấu chuỗi thư này là quan trọng.
markRead()	GmailThread	Đánh dấu chuỗi tin nhắn này là đã đọc.
markUnimportant()	GmailThread	Đánh dấu chuỗi tin nhắn này là không quan trọng.
markUnread()	GmailThread	Đánh dấu chuỗi thư này là chưa đọc.
moveToArchive()	GmailThread	Di chuyển chuỗi tin nhắn này vào mục lưu trữ.
moveToInbox()	GmailThread	Chuyển chuỗi thư này vào hộp thư đến.
moveToSpam()	GmailThread	Chuyển chuỗi tin nhắn này vào thư mục thư rác.
moveToTrash()	GmailThread	Chuyển chuỗi thư này vào thùng rác.
refresh()	GmailThread	Tải lại chuỗi thư này và trạng thái liên kết từ Gmail (rất hữu ích trong trường hợp các nhãn, trạng thái đã đọc, v.v. đã thay đổi).
removeLabel(label)	GmailThread	Xoá nhãn này khỏi chuỗi tin nhắn.
reply(body)	GmailThread	Trả lời người gửi thư cuối cùng trong chuỗi thư này bằng địa chỉ replyTo.
reply(body, options)	GmailThread	Trả lời người gửi thư cuối cùng trên chuỗi thư này bằng địa chỉ replyTo, với các đối số không bắt buộc.
replyAll(body)	GmailThread	Trả lời người gửi (sử dụng địa chỉ replyTo) và tất cả người nhận thư cuối cùng trên chuỗi thư này.
replyAll(body, options)	GmailThread	Trả lời người gửi (sử dụng địa chỉ replyTo) và tất cả người nhận thư gần đây nhất trên chuỗi thư này, với các đối số không bắt buộc.