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

Gmail Service

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.