Gmail Service

Gmail

Dịch vụ này cho phép bạn gửi email, soạn thảo, quản lý nhãn, đánh dấu thư và chuỗi thư, cũng như thực hiện nhiều tác vụ 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ênMô tả ngắn
GmailAppCho phép truy cập vào các chuỗi thư, thư và nhãn trong Gmail.
GmailAttachmentTệp đính kèm trong Gmail.
GmailDraftThư nháp do người dùng tạo trong tài khoản Gmail của người dùng.
GmailLabelNhãn do người dùng tạo trong tài khoản Gmail của người dùng.
GmailMessageMột thư trong tài khoản Gmail của người dùng.
GmailThreadMột chuỗi trong tài khoản Gmail của người dùng.

GmailApp

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
createDraft(recipient, subject, body)GmailDraftTạo một thư email nháp.
createDraft(recipient, subject, body, options)GmailDraftTạo thư email nháp bằng các đối số không bắt buộc.
createLabel(name)GmailLabelTạo nhãn người dùng mới có tên đã cho.
deleteLabel(label)GmailAppXoá nhãn đã chỉ định.
getAliases()String[]Lấy danh sách các email được thiết lập làm biệt hiệu cho tài khoản này trong Gmail.
getDraft(draftId)GmailDraftTruy xuất thư nháp bằng 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ả các chuỗi trong Hộp thư đến, bất kể nhãn.
getInboxThreads(start, max)GmailThread[]Truy xuất một dải các chuỗi trong hộp thư đến, bất kể nhãn.
getInboxUnreadCount()IntegerLấy số lượng chuỗi tin nhắn chưa đọc trong hộp thư đến.
getMessageById(id)GmailMessageNhận một 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ả các chuỗi trong hộp thư đến ưu tiên, bất kể nhãn.
getPriorityInboxThreads(start, max)GmailThread[]Truy xuất một dải các chuỗi thư trong Hộp thư ưu tiên, bất kể nhãn.
getPriorityInboxUnreadCount()IntegerLấy số lượng chuỗi chưa đọc trong Hộp thư ưu tiên.
getSpamThreads()GmailThread[]Truy xuất tất cả các chuỗi tin nhắn rác bất kể nhãn.
getSpamThreads(start, max)GmailThread[]Truy xuất một dải các chuỗi thư rác bất kể nhãn.
getSpamUnreadCount()IntegerLấy số lượng chuỗi tin nhắn chưa đọc là thư rác.
getStarredThreads()GmailThread[]Truy xuất tất cả các chuỗi có gắn dấu sao, bất kể nhãn.
getStarredThreads(start, max)GmailThread[]Truy xuất một dải các chuỗi có gắn dấu sao, bất kể nhãn.
getStarredUnreadCount()IntegerLấy số lượng chuỗi chưa đọc được gắn dấu sao.
getThreadById(id)GmailThreadLấy một luồng theo mã nhận dạng.
getTrashThreads()GmailThread[]Truy xuất tất cả các chuỗi trong thùng rác, bất kể nhãn.
getTrashThreads(start, max)GmailThread[]Truy xuất một dải các chuỗi trong thùng rác, bất kể nhãn.
getUserLabelByName(name)GmailLabelTruy xuất một nhãn theo 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 tin nhắn làm mới.
markMessageUnread(message)GmailAppĐánh dấu thư này là chưa đọc và buộc thư làm mới.
markMessagesRead(messages)GmailAppĐánh dấu những thư này là đã đọc và buộc thư làm mới.
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 chuỗi này là quan trọng và buộc chuỗi làm mới.
markThreadRead(thread)GmailAppĐánh dấu chuỗi này là đã đọc và buộc chuỗi làm mới.
markThreadUnimportant(thread)GmailAppĐánh dấu chuỗi này là không quan trọng và buộc chuỗi làm mới.
markThreadUnread(thread)GmailAppĐánh dấu chuỗi này là chưa đọc và buộc chuỗi làm mới.
markThreadsImportant(threads)GmailAppĐánh dấu các chuỗi này là quan trọng và buộc các chuỗi làm mới.
markThreadsRead(threads)GmailAppĐánh dấu các chuỗi này là đã đọc và buộc các chuỗi này làm mới.
markThreadsUnimportant(threads)GmailAppĐánh dấu các chuỗi này là không quan trọng và buộc các chuỗi làm mới.
markThreadsUnread(threads)GmailAppĐánh dấu các chuỗi này là chưa đọc và buộc các chuỗi làm mới.
moveMessageToTrash(message)GmailAppDi chuyển thư vào thùng rác và buộc thư làm mới.
moveMessagesToTrash(messages)GmailAppDi chuyển các thư được chỉ định vào thùng rác và buộc các thư làm mới.
moveThreadToArchive(thread)GmailAppDi chuyển luồng này vào kho lưu trữ và buộc luồng làm mới.
moveThreadToInbox(thread)GmailAppDi chuyển chuỗi này vào hộp thư đến và buộc chuỗi làm mới.
moveThreadToSpam(thread)GmailAppDi chuyển chuỗi này vào thư mục thư rác và buộc chuỗi này làm mới.
moveThreadToTrash(thread)GmailAppDi chuyển luồng này vào thùng rác và buộc luồng làm mới.
moveThreadsToArchive(threads)GmailAppDi chuyển các chuỗi này vào kho lưu trữ và buộc các chuỗi làm mới.
moveThreadsToInbox(threads)GmailAppDi chuyển các chuỗi này vào hộp thư đến và buộc các chuỗi làm mới.
moveThreadsToSpam(threads)GmailAppDi chuyển các chuỗi bài đăng này vào thư mục nội dung rác và buộc các chuỗi bài đăng làm mới.
moveThreadsToTrash(threads)GmailAppDi chuyển các chuỗi này vào thùng rác và buộc các chuỗi làm mới.
refreshMessage(message)GmailAppTải lại thư 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).
refreshMessages(messages)GmailAppTải lại thư và trạng thái liên quan từ Gmail (hữu ích trong trường hợp nhãn, trạng thái đã đọc, v.v. đã thay đổi).
refreshThread(thread)GmailAppTải lại chuỗi 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).
refreshThreads(threads)GmailAppTải lại các chuỗi 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).
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)GmailAppGửi một thư điện tử.
sendEmail(recipient, subject, body, options)GmailAppGửi thư điện tử có đối số không bắt buộc.
setCurrentMessageAccessToken(accessToken)voidĐặt mã truy cập thông báo 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)GmailAppThêm dấu sao vào thư này và buộc thư làm mới.
starMessages(messages)GmailAppThêm dấu sao vào những thư này và buộc các thư làm mới.
unstarMessage(message)GmailAppXoá dấu sao khỏi thư này và buộc thư làm mới.
unstarMessages(messages)GmailAppXoá dấu sao khỏi những thư này và buộc các thư làm mới.

GmailAttachment

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
copyBlob()BlobTrả về một bản sao của blob này.
getAs(contentType)BlobTrả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi sang loại nội dung đã chỉ định.
getBytes()Byte[]Lấy dữ liệu được lưu trữ trong blob này.
getContentType()StringLấy loại nội dung của các byte trong blob này.
getDataAsString()StringLấy dữ liệu của blob này dưới dạng một Chuỗi có phương thức mã hoá UTF-8.
getDataAsString(charset)StringLấy dữ liệu của blob này dưới dạng một chuỗi có phương thức mã hoá được chỉ định.
getHash()StringLấy hàm băm nội dung SHA1 cho tệp đính kèm này.
getName()StringLấy tên của blob này.
getSize()IntegerLấy kích thước của tệp đính kèm này.
isGoogleType()BooleanTrả về 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ó phương thức mã hoá UTF-8.
setDataFromString(string, charset)BlobĐặt dữ liệu của blob này từ một chuỗi có phương thức mã hoá được chỉ định.
setName(name)BlobĐặt tên cho blob này.

GmailDraft

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
deleteDraft()voidXoá bản nháp tin nhắn 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ư nháp này.
update(recipient, subject, body)GmailDraftThay thế nội dung của bản nháp tin nhắn 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.

GmailLabel

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
addToThread(thread)GmailLabelThêm nhãn này vào chuỗi đã cho và buộc chuỗi làm mới (GmailThread.refresh()).
addToThreads(threads)GmailLabelThêm nhãn này vào các luồng đã cho và buộc các luồng làm mới.
deleteLabel()voidXoá nhãn này.
getId()StringLấy mã nhận dạng của nhãn này.
getName()StringLấ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 các chuỗi được đánh dấu bằng nhãn này.
getUnreadCount()IntegerLấy số lượng chuỗi chưa đọc được gắn nhãn này.
removeFromThread(thread)GmailLabelXoá nhãn này khỏi luồng đã cho và buộc luồng làm mới.
removeFromThreads(threads)GmailLabelXoá nhãn này khỏi các chuỗi đã cho và buộc các chuỗi làm mới.

GmailMessage

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
createDraftReply(body)GmailDraftTạo một thư nháp để trả lời người gửi thư này bằng địa chỉ trả lời.
createDraftReply(body, options)GmailDraftTạo một 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)GmailDraftTạ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)GmailDraftTạ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)GmailMessageChuyển tiếp thư này đến người nhận mới.
forward(recipient, options)GmailMessageChuyể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()StringLấy danh sách người nhận được gửi bcc (gửi kín) cho thư này, phân tách bằng dấu phẩy.
getBody()StringLấy nội dung HTML của phần nội dung thư này.
getCc()StringLấ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()DateLấy ngày và giờ của thông báo này.
getFrom()StringLấy người gửi của thư này.
getHeader(name)StringLấy giá trị của một phần đầu thư RFC 2822 dựa trên tên phần đầu thư.
getId()StringLấy mã nhận dạng của thông báo này.
getPlainBody()StringLấy nội dung của phần nội dung thư này mà không có định dạng HTML.
getRawContent()StringLấy nội dung thô của thư này.
getReplyTo()StringLấy địa chỉ trả lời của thư này (thường là người gửi).
getSubject()StringLấy tiêu đề của thư này.
getThread()GmailThreadLấy luồng chứa thông báo này.
getTo()StringLấ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()BooleanCho biết thư này có phải là thư nháp hay không.
isInChats()BooleanCho biết liệu thông báo này có phải là thông báo trò chuyện hay không.
isInInbox()BooleanCho biết thư này có nằm trong hộp thư đến hay không.
isInPriorityInbox()BooleanTrả 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()BooleanCho biết thư này có nằm trong thùng rác hay không.
isStarred()BooleanCho biết thư này có được gắn dấu sao hay không.
isUnread()BooleanCho biết liệu thư này đã đọc hay chưa.
markRead()GmailMessageĐánh dấu thư là đã đọc.
markUnread()GmailMessageĐánh dấu thư là chưa đọc.
moveToTrash()GmailMessageDi chuyển thư vào thùng rác.
refresh()GmailMessageTả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)GmailMessageTrả lời người gửi thư này bằng địa chỉ trả lời.
reply(body, options)GmailMessageTrả lời người gửi thư này bằng địa chỉ trả lời, có thể kèm theo các đối số.
replyAll(body)GmailMessageTrả 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)GmailMessageTrả 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.
star()GmailMessageGắn dấu sao cho thư.
unstar()GmailMessageBỏ gắn dấu sao cho tin nhắn.

GmailThread

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
addLabel(label)GmailThreadThêm nhãn này vào chuỗi.
createDraftReply(body)GmailDraftTạo một thư nháp để trả lời người gửi tin nhắn gần đây nhất trong chuỗi này bằng địa chỉ trả lời.
createDraftReply(body, options)GmailDraftTạo một thư nháp để trả lời người gửi tin nhắn gần đây nhất trong chuỗi này bằng địa chỉ trả lời, kèm theo các đối số không bắt buộc.
createDraftReplyAll(body)GmailDraftTạo một thư nháp để trả lời người gửi thư gần đây nhất trong chuỗi thư này, bằng cách sử dụng địa chỉ trả lời và tất cả người nhận của thư này.
createDraftReplyAll(body, options)GmailDraftTạo một thư nháp để trả lời người gửi thư cuối cùng trong chuỗi 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()StringLấy tiêu đề của tin nhắn đầu tiên trong chuỗi.
getId()StringLấy mã nhận dạng của luồng này.
getLabels()GmailLabel[]Trả về các nhãn do người dùng tạo trên luồng này.
getLastMessageDate()DateLấy ngày của tin nhắn gần đây nhất trong chuỗi này.
getMessageCount()IntegerTrả về số lượng tin nhắn trong chuỗi trò chuyện.
getMessages()GmailMessage[]Lấy các tin nhắn trong chuỗi này.
getPermalink()StringLấy một đường liên kết cố định cho chuỗi này.
hasStarredMessages()BooleanTrả về xem chuỗi có tin nhắn được gắn dấu sao hay không.
isImportant()BooleanTrả về việc chuỗi có được đánh dấu là quan trọng hay không.
isInChats()BooleanTrả về cho dù chuỗi có được gắn nhãn là cuộc trò chuyện hay không.
isInInbox()BooleanTrả về việc chuỗi có nằm trong hộp thư đến hay không.
isInPriorityInbox()BooleanTrả về true nếu chuỗi thư này nằm trong hộp thư đến ưu tiên; trả về false trong trường hợp ngược lại.
isInSpam()BooleanTrả về xem chuỗi có được đánh dấu là nội dung rác hay không.
isInTrash()BooleanTrả về việc luồng có nằm trong thùng rác hay không.
isUnread()BooleanTrả về liệu chuỗi có tin nhắn chưa đọc hay không.
markImportant()GmailThreadĐánh dấu chuỗi này là quan trọng.
markRead()GmailThreadĐánh dấu chuỗi này là đã đọc.
markUnimportant()GmailThreadĐánh dấu chuỗi này là không quan trọng.
markUnread()GmailThreadĐánh dấu chuỗi này là chưa đọc.
moveToArchive()GmailThreadDi chuyển chuỗi này vào kho lưu trữ.
moveToInbox()GmailThreadChuyển chuỗi này vào hộp thư đến.
moveToSpam()GmailThreadChuyển chuỗi bài đăng này vào thư mục nội dung rác.
moveToTrash()GmailThreadChuyển chuỗi tin nhắn này vào thùng rác.
refresh()GmailThreadTải lại chuỗ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).
removeLabel(label)GmailThreadXoá nhãn này khỏi chuỗi thư.
reply(body)GmailThreadTrả lời người gửi tin nhắn gần đây nhất trong chuỗi này bằng địa chỉ replyTo.
reply(body, options)GmailThreadTrả lời người gửi của thư cuối cùng trong chuỗi này bằng địa chỉ replyTo, kèm theo các đối số không bắt buộc.
replyAll(body)GmailThreadTrả lời người gửi (bằng địa chỉ replyTo) và tất cả người nhận của thư cuối cùng trong chuỗi thư này.
replyAll(body, options)GmailThreadTrả lời người gửi (bằng địa chỉ replyTo) và tất cả người nhận của thư cuối cùng trong chuỗi thư này, kèm theo các đối số không bắt buộc.