Class GmailApp

GmailApp

Cấp quyền truy cập vào các chuỗi thư, thư và nhãn trong Gmail.

Phương thức

Phương thức	Kiểu 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 thư email nháp bằng các đối số không bắt buộc.
createLabel(name)	GmailLabel	Tạo nhãn người dùng mới của tên đã đặt.
deleteLabel(label)	GmailApp	Xoá nhãn đã chỉ định.
getAliases()	String[]	Nhận danh sách các email được thiết lập làm email đại diện 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[]	Nhận tất cả thư nháp trong Gmail.
getInboxThreads()	GmailThread[]	Truy xuất tất cả chuỗi trong Hộp thư đến, bất kể nhãn.
getInboxThreads(start, max)	GmailThread[]	Truy xuất một loạt chuỗi trong Hộp thư đến, bất kể nhãn.
getInboxUnreadCount()	Integer	Xem số chuỗi thư chưa đọc trong hộp thư đến.
getMessageById(id)	GmailMessage	Nhận tin nhắn theo mã nhận dạng.
getMessagesForThread(thread)	GmailMessage[]	Truy xuất tất cả thư trong chuỗi được chỉ định.
getMessagesForThreads(threads)	GmailMessage[][]	Truy xuất tất cả thông báo trong chuỗi được chỉ định.
getPriorityInboxThreads()	GmailThread[]	Truy xuất tất cả chuỗi trong Hộp thư ưu tiên, bất kể nhãn.
getPriorityInboxThreads(start, max)	GmailThread[]	Truy xuất một loạt chuỗi trong Hộp thư ưu tiên, bất kể nhãn.
getPriorityInboxUnreadCount()	Integer	Xem số lượng chuỗi tin nhắn 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	Xem số lượng chuỗi tin nhắn chưa đọc là tin nhắn 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 loạt chuỗi có gắn dấu sao, bất kể nhãn.
getStarredUnreadCount()	Integer	Xem số lượng chuỗi tin nhắn chưa đọc được gắn dấu sao.
getThreadById(id)	GmailThread	Tìm một chuỗi theo mã nhận dạng.
getTrashThreads()	GmailThread[]	Truy xuất tất cả chuỗi thùng rác, bất kể nhãn.
getTrashThreads(start, max)	GmailThread[]	Truy xuất một loạt chuỗi thùng rác, bất kể nhãn.
getUserLabelByName(name)	GmailLabel	Truy xuấ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 thông báo này là đã đọc và buộc thông báo làm mới.
markMessageUnread(message)	GmailApp	Đánh dấu thông báo này là chưa đọc và buộc làm mới thông báo.
markMessagesRead(messages)	GmailApp	Đánh dấu các thông báo này là đã đọc và buộc làm mới thông báo.
markMessagesUnread(messages)	GmailApp	Đánh dấu các thông báo này là chưa đọc và buộc làm mới thông báo.
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 này là đã đọc và buộc chuỗi làm mới.
markThreadUnimportant(thread)	GmailApp	Đánh dấu luồng này là không quan trọng và buộc luồng 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 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 luồng này là đã đọc và buộc các luồng 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 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)	GmailApp	Chuyển thư vào thùng rác và buộc thư làm mới.
moveMessagesToTrash(messages)	GmailApp	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)	GmailApp	Di chuyển chuỗi này sang mục lưu trữ và buộc chuỗi làm mới.
moveThreadToInbox(thread)	GmailApp	Di chuyển chuỗi này tới hộp thư đến và buộc chuỗi làm mới.
moveThreadToSpam(thread)	GmailApp	Chuyển chuỗi này sang thư mục nội dung rác và buộc chuỗi làm mới.
moveThreadToTrash(thread)	GmailApp	Chuyển chuỗi này vào thùng rác và buộc chuỗi làm mới.
moveThreadsToArchive(threads)	GmailApp	Di chuyển các luồng này tới mục lưu trữ và buộc các luồng làm mới.
moveThreadsToInbox(threads)	GmailApp	Di chuyển các chuỗi này tới hộp thư đến và buộc các chuỗi làm mới.
moveThreadsToSpam(threads)	GmailApp	Chuyển những chuỗi này sang mục nội dung rác và buộc các chuỗi làm mới.
moveThreadsToTrash(threads)	GmailApp	Chuyển các luồng này vào thùng rác và buộc các luồng làm mới.
refreshMessage(message)	GmailApp	Tả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)	GmailApp	Tải lại các 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).
refreshThread(thread)	GmailApp	Tả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)	GmailApp	Tả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)	GmailApp	Gửi email.
sendEmail(recipient, subject, body, options)	GmailApp	Gửi email với cá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)	GmailApp	Thêm một dấu sao vào thư này và buộc làm mới thư.
starMessages(messages)	GmailApp	Thêm dấu sao vào những thư này và buộc thư làm mới.
unstarMessage(message)	GmailApp	Xoá một 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.

Các phương thức ngừng hoạt động

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
getChatThreads()	GmailThread[]	Nhận tất cả chuỗi tin nhắn trên Google Hangouts phiên bản cũ và chuỗi tin nhắn trên Google Chat cho đến khi Google chuyển tất cả người dùng Hangouts phiên bản cũ sang Chat vào cuối năm nay.
getChatThreads(start, max)	GmailThread[]	Nhận một loạt chuỗi tin nhắn trên Google Hangouts phiên bản cũ và các chuỗi tin nhắn trên Google Chat cho đến khi Google chuyển tất cả người dùng Hangouts phiên bản cũ sang Chat vào cuối năm nay.

Tài liệu chi tiết

createDraft(recipient, subject, body)

Tạo thư email nháp. Kích thước của email (bao gồm cả tiêu đề) là hạn mức.

// The code below creates a draft email with the current date and time.
var now = new Date();
GmailApp.createDraft("[e-mail]", "current time", "The time is: " + now.toString());

Thông số

Tên	Loại	Nội dung 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 đề của email
body	String	nội dung email

Hai chiều

GmailDraft — GmailBản nháp mới được 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• createDraft(recipient, subject, body, options)

---

createDraft(recipient, subject, body, options)

Tạo thư email nháp 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 tiêu đề, nhưng không bao gồm tệp đính kèm) bị giới hạn trong hạn mức.

// Create a draft email with a file from Google Drive attached as a PDF.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.createDraft('[e-mail]', 'Attachment example', 'Please see attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

Thông số

Tên	Loại	Nội dung mô tả
recipient	String	địa chỉ của người nhận
subject	String	dòng tiêu đề
body	String	nội dung email
options	Object	đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây

Thông số nâng cao

Tên	Loại	Nội dung mô tả
attachments	BlobSource[]	một mảng tệp để gửi kèm theo email
bcc	String	danh sách được phân tách bằng dấu phẩy gồm các địa chỉ email gửi tới BCC
cc	String	danh sách địa chỉ email được phân tách bằng dấu phẩy
from	String	địa chỉ dùng để gửi email. Địa chỉ này phải là một trong những giá trị được getAliases() trả về
htmlBody	String	Nếu được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng HTML đó thay vì đối số nội dung bắt buộc; bạn có thể thêm một trường inlineImages không bắt buộc trong nội dung HTML nếu bạn có hình ảnh cùng dòng cho email của mình
inlineImages	Object	một đối tượng JavaScript chứa đường liên kết từ khoá hình ảnh (String) đến dữ liệu hình ảnh (BlobSource); thuộc tính này giả định rằng tham số htmlBody được sử dụng và chứa thông tin 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)

Hai chiều

GmailDraft — GmailBản nháp mới được 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• createDraft(recipient, subject, body)

---

createLabel(name)

Tạo nhãn người dùng mới của tên đã đặt.

// Creates the label @FOO and logs label: FOO
Logger.log("label: " + GmailApp.createLabel("FOO"));

Thông số

Tên	Loại	Nội dung mô tả
name	String	tên của nhãn mới

Hai chiều

GmailLabel – nhãn mới được 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• deleteLabel(label)

---

deleteLabel(label)

Xoá nhãn đã chỉ định.

// Have to get the label by name first
var label = GmailApp.getUserLabelByName("FOO");
GmailApp.deleteLabel(label);

Thông số

Tên	Loại	Nội dung mô tả
label	GmailLabel	nhãn cần xoá

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• createLabel(name)

---

getAliases()

Nhận danh sách các email được thiết lập làm email đại diện cho tài khoản này trong Gmail.

Bạn có thể gửi thư từ bất kỳ bí danh nào trong số này bằng cách sử dụng đối số tùy chọn "từ".

// Log the aliases for this Gmail account and send an email as the first one.
var me = Session.getActiveUser().getEmail();
var aliases = GmailApp.getAliases();
Logger.log(aliases);
if (aliases.length > 0) {
  GmailApp.sendEmail(me, 'From an alias', 'A message from an alias!', {'from': aliases[0]});
} else {
  GmailApp.sendEmail(me, 'No aliases found', 'You have no aliases.');
}

Hai chiều

String[] — một loạt các bí danh cho tài khoản 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• sendEmail(recipient, subject, body, options)

---

getDraft(draftId)

Truy xuất thư nháp theo mã nhận dạng.

Sử dụng mã này cùng với getId() trên thư nháp trong Gmail.

// Get the first draft message in your drafts folder
var draft = GmailApp.getDrafts()[0];
// Get its ID
var draftId = draft.getId();
// Now fetch the same draft using that ID.
var draftById = GmailApp.getDraft(draftId);
// Should always log true as they should be the same message
Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());

Thông số

Tên	Loại	Nội dung mô tả
draftId	String	mã nhận dạng của bản nháp cần truy xuất

Hai chiều

GmailDraft — bản nháp có mã nhận dạng đã cho

Gửi

Error — nếu không tìm thấy bản nháp nào có mã nhận dạng đã cho

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getDraftMessages()

Truy xuất tất cả thư nháp.

// Logs the number of draft messages
var drafts = GmailApp.getDraftMessages();
Logger.log(drafts.length);

Hai chiều

GmailMessage[] – một loạt thư nháp trên Gmail

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getDrafts()

Nhận tất cả thư nháp trong Gmail.

var drafts = GmailApp.getDrafts();
for (var i = 0; i < drafts.length; i++) {
  Logger.log(drafts[i].getId());
}

Hai chiều

GmailDraft[] – một loạt thư nháp trong Gmail

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getInboxThreads()

Truy xuất tất cả chuỗi trong Hộp thư đến, bất kể nhãn.

Lệnh gọi này sẽ không thực hiện được khi kích thước của tất cả các luồng quá lớn để hệ thống có thể xử lý. Khi kích thước luồng không xác định và có thể rất lớn, vui lòng sử dụng lệnh gọi "phân trang" và chỉ định phạm vi luồng để truy xuất trong mỗi lệnh gọi.

// Log the subject lines of your Inbox
var threads = GmailApp.getInboxThreads();
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Hai chiều

GmailThread[] — một loạt các chuỗi thư Gmail trong Hộp thư đến

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getInboxThreads(start, max)

Truy xuất một loạt chuỗi trong Hộp thư đến, bất kể nhãn.

// Log the subject lines of up to the first 50 emails in your Inbox
var threads = GmailApp.getInboxThreads(0, 50);
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Thông số

Tên	Loại	Nội dung mô tả
start	Integer	chỉ mục của luồng đầu tiên cần truy xuất
max	Integer	số lượng chuỗi tối đa cần truy xuất

Hai chiều

GmailThread[] — một loạt các chuỗi thư Gmail trong Hộp thư đến

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getInboxUnreadCount()

Xem số chuỗi thư chưa đọc trong hộp thư đến.

Logger.log("Messages unread in inbox: " + GmailApp.getInboxUnreadCount());

Hai chiều

Integer – số chuỗi thư trong hộp thư đến có thư chưa đọc

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getMessageById(id)

Nhận tin nhắn theo mã nhận dạng.

Sử dụng mã này cùng với getId() trên thư Gmail.

// Get the first message in the first thread of your inbox
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
// Get its ID
var messageId = message.getId();
// Now fetch the same message using that ID.
var messageById = GmailApp.getMessageById(messageId);
// Should always log true as they should be the same message
Logger.log(message.getSubject() == messageById.getSubject());

Thông số

Tên	Loại	Nội dung mô tả
id	String	mã nhận dạng của thư cần truy xuất

Hai chiều

GmailMessage – tin nhắn có mã nhận dạng đã cho

Gửi

Error — nếu không tìm thấy thư nào có mã nhận dạng đã cho

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• getThreadById(id)

---

getMessagesForThread(thread)

Truy xuất tất cả thư trong chuỗi được chỉ định.

// Log all the subject lines in the first thread of your inbox
var thread = GmailApp.getInboxThreads(0, 1)[0];
var messages = GmailApp.getMessagesForThread(thread);
for (var i = 0 ; i < messages.length; i++) {
  Logger.log("subject: " + messages[i].getSubject());
}

Thông số

Tên	Loại	Nội dung mô tả
thread	GmailThread	chuỗi thông báo cần truy xuất

Hai chiều

GmailMessage[] – mảng thông báo tương ứng với chuỗi 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• getMessagesForThreads(threads)

---

getMessagesForThreads(threads)

Truy xuất tất cả thông báo trong chuỗi được chỉ định.

// Log the subject lines of all messages in the first two threads of your inbox
var thread = GmailApp.getInboxThreads(0, 2);
var messages = GmailApp.getMessagesForThreads(thread);
for (var i = 0 ; i < messages.length; i++) {
  for (var j = 0; j < messages[i].length; j++) {
    Logger.log("subject: " + messages[i][j].getSubject());
  }
}

Thông số

Tên	Loại	Nội dung mô tả
threads	GmailThread[]	chuỗi thông báo cần truy xuất

Hai chiều

GmailMessage[][] – một mảng các thông điệp, trong đó mỗi mục ở mảng bên ngoài tương ứng với một luồng, còn mảng bên trong chứa các thông điệp trong luồ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• getMessagesForThread(thread)

---

getPriorityInboxThreads()

Truy xuất tất cả chuỗi trong Hộp thư ưu tiên, bất kể nhãn.

Lệnh gọi này sẽ không thực hiện được khi kích thước của tất cả các luồng quá lớn để hệ thống có thể xử lý. Khi kích thước luồng không xác định và có thể rất lớn, vui lòng sử dụng lệnh gọi "phân trang" và chỉ định phạm vi luồng để truy xuất trong mỗi lệnh gọi.

Logger.log("# of messages in your Priority Inbox: " +
           GmailApp.getPriorityInboxThreads().length);

Hai chiều

GmailThread[] — một loạt các chuỗi thư Gmail trong Hộp thư ưu tiên

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getPriorityInboxThreads(start, max)

Truy xuất một loạt chuỗi trong Hộp thư ưu tiên, bất kể nhãn.

// Will log some number 2 or less
Logger.log("# of messages in your Priority Inbox: " +
           GmailApp.getPriorityInboxThreads(0, 2).length);

Thông số

Tên	Loại	Nội dung mô tả
start	Integer	chỉ mục của luồng đầu tiên cần truy xuất
max	Integer	số lượng chuỗi tối đa cần truy xuất

Hai chiều

GmailThread[] — một loạt các chuỗi thư Gmail trong Hộp thư ưu tiên

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getPriorityInboxUnreadCount()

Xem số lượng chuỗi tin nhắn chưa đọc trong Hộp thư ưu tiên.

Logger.log("Number of unread emails in your Priority Inbox : " +
           GmailApp.getPriorityInboxUnreadCount());

Hai chiều

Integer — số chuỗi thư trong Hộp thư ưu tiên có thư chưa đọc

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getSpamThreads()

Truy xuất tất cả chuỗi thư rác, bất kể nhãn.

Lệnh gọi này sẽ không thực hiện được khi kích thước của tất cả các luồng quá lớn để hệ thống có thể xử lý. Khi kích thước luồng không xác định và có thể rất lớn, vui lòng sử dụng lệnh gọi "phân trang" và chỉ định phạm vi luồng để truy xuất trong mỗi lệnh gọi.

Logger.log("# of total spam threads: " + GmailApp.getSpamThreads().length);

Hai chiều

GmailThread[] – một mảng các chuỗi thư Gmail trong thư mục thư rác

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getSpamThreads(start, max)

Truy xuất một loạt chuỗi thư rác, bất kể nhãn.

// Will log a number at most 5
Logger.log("# of total spam threads: " + GmailApp.getSpamThreads(0, 5).length);

Thông số

Tên	Loại	Nội dung mô tả
start	Integer	chỉ mục của luồng đầu tiên cần truy xuất
max	Integer	số lượng chuỗi tối đa cần truy xuất

Hai chiều

GmailThread[] – một mảng các chuỗi thư Gmail trong thư mục thư rác

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getSpamUnreadCount()

Xem số lượng chuỗi tin nhắn chưa đọc là tin nhắn rác.

// Unless you actually read stuff in your spam folder, this should be the same as
// the number of messages in your spam folder.
Logger.log("# unread threads that are spam: " + GmailApp.getSpamUnreadCount());

Hai chiều

Integer – số chuỗi thư rác có tin nhắn chưa đọc

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getStarredThreads()

Truy xuất tất cả các chuỗi có gắn dấu sao, bất kể nhãn.

Lệnh gọi này sẽ không thực hiện được khi kích thước của tất cả các luồng quá lớn để hệ thống có thể xử lý. Khi kích thước luồng không xác định và có thể rất lớn, vui lòng sử dụng lệnh gọi "phân trang" và chỉ định phạm vi luồng để truy xuất trong mỗi lệnh gọi.

// Logs the number of starred threads
Logger.log("# Starred threads: " + GmailApp.getStarredThreads().length);

Hai chiều

GmailThread[] — một loạt chuỗi thư có gắn dấu sao trong Gmail

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getStarredThreads(start, max)

Truy xuất một loạt chuỗi có gắn dấu sao, bất kể nhãn.

// Logs the number of starred threads to a maximum of 5
Logger.log("# Starred threads: " + GmailApp.getStarredThreads(0, 5).length);

Thông số

Tên	Loại	Nội dung mô tả
start	Integer	chỉ mục của luồng đầu tiên cần truy xuất
max	Integer	số lượng chuỗi tối đa cần truy xuất

Hai chiều

GmailThread[] — một loạt chuỗi thư có gắn dấu sao trong Gmail

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getStarredUnreadCount()

Xem số lượng chuỗi tin nhắn chưa đọc được gắn dấu sao.

Logger.log("# unread and starred: " + GmailApp.getStarredUnreadCount());

Hai chiều

Integer – số lượng chuỗi tin nhắn có gắn dấu sao có tin nhắn chưa đọc

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getThreadById(id)

Tìm một chuỗi theo mã nhận dạng.

Sử dụng mã này cùng với getId() trên các chuỗi thư trong Gmail.

// Gets the first inbox thread.
const firstThread = GmailApp.getInboxThreads(0,1)[0];
// Gets the same thread by ID.
const threadById = GmailApp.getThreadById(firstThread.getId());
// Verifies that they are the same.
console.log(firstThread.getFirstMessageSubject() === threadById.getFirstMessageSubject());

Thông số

Tên	Loại	Nội dung mô tả
id	String	Mã nhận dạng của luồng cần truy xuất.

Hai chiều

GmailThread – Luồng có mã nhận dạng đã cho hoặc null nếu không tìm thấ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• getMessageById(id)

---

getTrashThreads()

Truy xuất tất cả chuỗi thùng rác, bất kể nhãn.

Lệnh gọi này sẽ không thực hiện được khi kích thước của tất cả các luồng quá lớn để hệ thống có thể xử lý. Khi kích thước luồng không xác định và có thể rất lớn, vui lòng sử dụng lệnh gọi "phân trang" và chỉ định phạm vi luồng để truy xuất trong mỗi lệnh gọi.

Logger.log("# of total trash threads: " + GmailApp.getTrashThreads().length);

Hai chiều

GmailThread[] — một loạt các chuỗi thư Gmail trong thùng rác

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getTrashThreads(start, max)

Truy xuất một loạt chuỗi thùng rác, bất kể nhãn.

// Will log a number at most 5
Logger.log("# of total trash threads: " + GmailApp.getTrashThreads(0, 5).length);

Thông số

Tên	Loại	Nội dung mô tả
start	Integer	chỉ mục của luồng đầu tiên cần truy xuất
max	Integer	số lượng chuỗi tối đa cần truy xuất

Hai chiều

GmailThread[] — một loạt các chuỗi thư Gmail trong thùng rác

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getUserLabelByName(name)

Truy xuất nhãn theo tên nhãn.

var labelObject = GmailApp.getUserLabelByName("myLabel");

Thông số

Tên	Loại	Nội dung mô tả
name	String	tên của nhãn cần truy xuất

Hai chiều

GmailLabel — nhãn Gmail có tên cụ 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getUserLabels()

Truy xuất danh sách nhãn do người dùng tạo.

// Logs all of the names of your labels
var labels = GmailApp.getUserLabels();
for (var i = 0; i < labels.length; i++) {
  Logger.log("label: " + labels[i].getName());
}

Hai chiều

GmailLabel[] – mảng nhãn do người dùng 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

markMessageRead(message)

Đánh dấu thông báo này là đã đọc và buộc thông báo làm mới.

// Mark the first message in the first thread of your inbox as read
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageRead(message);

Thông số

Tên	Loại	Nội dung mô tả
message	GmailMessage	tin nhắn cần đánh dấu là đã đọc

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• markMessageUnread(message)

---

markMessageUnread(message)

Đánh dấu thông báo này là chưa đọc và buộc làm mới thông báo.

// Mark the first message in the first thread of your inbox as unread
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageUnread(message);

Thông số

Tên	Loại	Nội dung mô tả
message	GmailMessage	tin nhắn để đánh dấu là chưa đọc

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• markMessageRead(message)

---

markMessagesRead(messages)

Đánh dấu các thông báo này là đã đọc và buộc làm mới thông báo.

// Mark first three messages in the first inbox thread as read.
// Assumes that the first inbox thread has 3 messages in it.
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesRead(thread.getMessages());

Thông số

Tên	Loại	Nội dung mô tả
messages	GmailMessage[]	một loạt thông báo để đánh dấu là đã đọc

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• markMessagesUnread(messages)

---

markMessagesUnread(messages)

Đánh dấu các thông báo này là chưa đọc và buộc làm mới thông báo.

// Mark first three messages in the first inbox thread as unread.
// Assumes that the first inbox thread has 3 messages in it
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesUnread(thread.getMessages());

Thông số

Tên	Loại	Nội dung mô tả
messages	GmailMessage[]	một loạt các thông báo để đánh dấu là chưa đọc

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• markMessagesRead(messages)

---

markThreadImportant(thread)

Đánh dấu luồng này là quan trọng và buộc luồng làm mới.

// Marks first inbox thread as important
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadImportant(thread);

Thông số

Tên	Loại	Nội dung mô tả
thread	GmailThread	chuỗi thư cần đánh dấu là quan trọng

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• markThreadUnimportant(thread)

---

markThreadRead(thread)

Đánh dấu chuỗi này là đã đọc và buộc chuỗi làm mới.

// Marks first inbox thread as read
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadRead(thread);

Thông số

Tên	Loại	Nội dung mô tả
thread	GmailThread	chuỗi cần đánh dấu là đã đọc

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• markThreadUnread(thread)

---

markThreadUnimportant(thread)

Đánh dấu luồng này là không quan trọng và buộc luồng làm mới.

// Marks first inbox thread as unimportant
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnimportant(thread);

Thông số

Tên	Loại	Nội dung mô tả
thread	GmailThread	chuỗi thư để đánh dấu là không quan trọng

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• markThreadImportant(thread)

---

markThreadUnread(thread)

Đánh dấu chuỗi này là chưa đọc và buộc chuỗi làm mới.

// Marks first inbox thread as unread
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnread(thread);

Thông số

Tên	Loại	Nội dung mô tả
thread	GmailThread	chuỗi tin nhắn cần đánh dấu là chưa đọc

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• markThreadRead(thread)

---

markThreadsImportant(threads)

Đánh dấu các luồng này là quan trọng và buộc các luồng làm mới.

// Marks first two threads in inbox as important
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsImportant(threads);

Thông số

Tên	Loại	Nội dung mô tả
threads	GmailThread[]	một loạt các luồng để đánh dấu là quan trọng

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• markThreadsUnimportant(threads)

---

markThreadsRead(threads)

Đánh dấu các luồng này là đã đọc và buộc các luồng làm mới.

// Marks first two threads in inbox as read
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsRead(threads);

Thông số

Tên	Loại	Nội dung mô tả
threads	GmailThread[]	một mảng chuỗi để đánh dấu là đã đọc

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• markThreadsUnread(threads)

---

markThreadsUnimportant(threads)

Đánh dấu các luồng này là không quan trọng và buộc các luồng làm mới.

// Marks first two threads in inbox as unimportant
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnimportant(threads);

Thông số

Tên	Loại	Nội dung mô tả
threads	GmailThread[]	một loạt chuỗi để đánh dấu là không quan trọng

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• markThreadsImportant(threads)

---

markThreadsUnread(threads)

Đánh dấu các chuỗi này là chưa đọc và buộc các chuỗi làm mới.

// Marks first two threads in inbox as unread
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnread(threads);

Thông số

Tên	Loại	Nội dung mô tả
threads	GmailThread[]	một mảng chuỗi để đánh dấu là chưa đọc

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• markThreadsRead(threads)

---

moveMessageToTrash(message)

Chuyển thư vào thùng rác và buộc thư làm mới.

// Move the first message in your inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var firstMessage = firstThread.getMessages()[0];
GmailApp.moveMessageToTrash(firstMessage);

Thông số

Tên	Loại	Nội dung mô tả
message	GmailMessage	thư đưa vào thùng rác

Hai chiều

GmailApp — dịch vụ Gmail (hữu ích cho chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• moveMessagesToTrash(messages)

---

moveMessagesToTrash(messages)

Chuyển các thư được chỉ định vào thùng rác và buộc các thư đó làm mới.

// Move first two messages in your inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var messages = firstThread.getMessages();
var toDelete = [messages[0], messages[1]];
GmailApp.moveMessagesToTrash(toDelete);

Thông số

Tên	Loại	Nội dung mô tả
messages	GmailMessage[]	thư đưa vào thùng rác

Hai chiều

GmailApp — dịch vụ Gmail (hữu ích cho chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• moveMessageToTrash(message)

---

moveThreadToArchive(thread)

Di chuyển chuỗi này sang mục lưu trữ và buộc chuỗi làm mới.

// Archive the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToArchive(firstThread);

Thông số

Tên	Loại	Nội dung mô tả
thread	GmailThread	chuỗi cần lưu trữ

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• moveThreadToInbox(thread)
• moveThreadToSpam(thread)
• moveThreadToTrash(thread)

---

moveThreadToInbox(thread)

Di chuyển chuỗi này tới hộp thư đến và buộc chuỗi làm mới.

// Find a thread not already in your inbox
var thread = GmailApp.search("-in:inbox")[0]; // Get the first one
GmailApp.moveThreadToInbox(thread);

Thông số

Tên	Loại	Nội dung mô tả
thread	GmailThread	chuỗi thư cần chuyển tới hộp thư đến

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• moveThreadToTrash(thread)
• moveThreadToSpam(thread)
• moveThreadToArchive(thread)

---

moveThreadToSpam(thread)

Chuyển chuỗi này sang thư mục nội dung rác và buộc chuỗi làm mới.

// Tag first thread in inbox as spam
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToSpam(firstThread);

Thông số

Tên	Loại	Nội dung mô tả
thread	GmailThread	chuỗi cuộc trò chuyện cần chuyển vào thư mục nội dung làm phiền

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• moveThreadToTrash(thread)
• moveThreadToInbox(thread)
• moveThreadToArchive(thread)

---

moveThreadToTrash(thread)

Chuyển chuỗi này vào thùng rác và buộc chuỗi làm mới.

// Move first thread in inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToTrash(firstThread);

Thông số

Tên	Loại	Nội dung mô tả
thread	GmailThread	chuỗi thư đã được chuyển vào thùng rác

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• moveThreadToInbox(thread)
• moveThreadToSpam(thread)
• moveThreadToArchive(thread)

---

moveThreadsToArchive(threads)

Di chuyển các luồng này tới mục lưu trữ và buộc các luồng làm mới.

// Move first two threads in your inbox to the archive
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToArchive(firstTwoThreads);

Thông số

Tên	Loại	Nội dung mô tả
threads	GmailThread[]	một mảng chuỗi sẽ được lưu trữ

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• moveThreadsToInbox(threads)
• moveThreadsToSpam(threads)
• moveThreadsToTrash(threads)

---

moveThreadsToInbox(threads)

Di chuyển các chuỗi này tới hộp thư đến và buộc các chuỗi làm mới.

// Find two threads not already in your inbox
var firstTwoThreads = GmailApp.search("-in:inbox", 0, 2);
GmailApp.moveThreadsToInbox(firstTwoThreads);

Thông số

Tên	Loại	Nội dung mô tả
threads	GmailThread[]	một loạt chuỗi thư cần được chuyển vào hộp thư đến

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• moveThreadsToTrash(threads)
• moveThreadsToSpam(threads)
• moveThreadsToArchive(threads)

---

moveThreadsToSpam(threads)

Chuyển những chuỗi này sang mục nội dung rác và buộc các chuỗi làm mới.

// Move first two threads in your inbox to spam
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToSpam(firstTwoThreads);

Thông số

Tên	Loại	Nội dung mô tả
threads	GmailThread[]	một mảng chuỗi sẽ được chuyển vào thư mục nội dung rác

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• moveThreadsToInbox(threads)
• moveThreadsToTrash(threads)
• moveThreadsToArchive(threads)

---

moveThreadsToTrash(threads)

Chuyển các luồng này vào thùng rác và buộc các luồng làm mới.

// Move first two threads in your inbox to trash
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToTrash(firstTwoThreads);

Thông số

Tên	Loại	Nội dung mô tả
threads	GmailThread[]	một loạt luồng cần chuyển vào thùng rác

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• moveThreadsToInbox(threads)
• moveThreadsToSpam(threads)
• moveThreadsToArchive(threads)

---

refreshMessage(message)

Tả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).

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var firstMessage = firstThread.getMessages()[0];
// ...Do something that may take a while here....
GmailApp.refreshMessage(firstMessage);
// ...Do more stuff with firstMessage...

Thông số

Tên	Loại	Nội dung mô tả
message	GmailMessage	tin nhắn cần làm mới

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• refreshMessages(messages)

---

refreshMessages(messages)

Tải lại các 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).

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 2);
// ...Do something that may take a while here....
GmailApp.refreshMessages(coupleOfMessages);
// ...Do more stuff with coupleOfMessages...

Thông số

Tên	Loại	Nội dung mô tả
messages	GmailMessage[]	tin nhắn cần làm mới

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• refreshMessage(message)

---

refreshThread(thread)

Tả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).

var firstThread = GmailApp.getInboxThreads(0,1)[0];
// ...Do something that may take a while here....
GmailApp.refreshThread(firstThread);
// ... Do more stuff with the thread ...

Thông số

Tên	Loại	Nội dung mô tả
thread	GmailThread	chuỗi cần làm mới

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• refreshThreads(threads)

---

refreshThreads(threads)

Tả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).

var threads = GmailApp.getInboxThreads(0, 3);
// ...Do something that may take a while here....
GmailApp.refreshThreads(threads);
// ... Do more stuff with threads ...

Thông số

Tên	Loại	Nội dung mô tả
threads	GmailThread[]	chuỗi cần làm mới

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• refreshThread(thread)

---

search(query)

Tìm kiếm trong Gmail bằng cụm từ tìm kiếm đã cho.

Lệnh gọi này sẽ không thực hiện được khi kích thước của tất cả các luồng quá lớn để hệ thống có thể xử lý. Khi kích thước luồng không xác định và có thể rất lớn, vui lòng sử dụng lệnh gọi "phân trang" và chỉ định phạm vi luồng để truy xuất trong mỗi lệnh gọi.

// Find starred messages with subject IMPORTANT
var threads = GmailApp.search('is:starred subject:"IMPORTANT"');

Thông số

Tên	Loại	Nội dung mô tả
query	String	cụm từ tìm kiếm, giống như khi bạn nhập vào Gmail

Hai chiều

GmailThread[] — một mảng các chuỗi Gmail khớp với truy vấn 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

search(query, start, max)

Tìm kiếm trong Gmail bằng cụm từ tìm kiếm đã cho.

// Find starred messages with subject IMPORTANT and return second batch of 10.
// Assumes there are at least 11 of them, otherwise this will return an empty array.
var threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);

Thông số

Tên	Loại	Nội dung mô tả
query	String	cụm từ tìm kiếm, giống như khi bạn nhập vào Gmail
start	Integer	chỉ mục của luồng bắt đầu
max	Integer	số lượng luồng tối đa cần trả về

Hai chiều

GmailThread[] — một mảng các chuỗi Gmail khớp với truy vấn 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

sendEmail(recipient, subject, body)

Gửi email. Kích thước của email (bao gồm cả tiêu đề) là hạn mức.

// The code below will send an email with the current date and time.
var now = new Date();
GmailApp.sendEmail("[e-mail]", "current time", "The time is: " + now.toString());

Thông số

Tên	Loại	Nội dung 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 đề của email (tối đa 250 ký tự)
body	String	nội dung email

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• sendEmail(recipient, subject, body, options)

---

sendEmail(recipient, subject, body, options)

Gửi email với các đối số không bắt buộc. Email có thể chứa văn bản thuần tuý hoặc phần nội dung HTML. Kích thước của email (bao gồm tiêu đề, nhưng không bao gồm tệp đính kèm) bị giới hạn trong hạn mức.

// Send an email with a file from Google Drive attached as a PDF.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.sendEmail('[e-mail]', 'Attachment example', 'Please see the attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

Thông số

Tên	Loại	Nội dung mô tả
recipient	String	địa chỉ của người nhận
subject	String	dòng chủ đề (tối đa 250 ký tự)
body	String	nội dung email
options	Object	đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây

Thông số nâng cao

Tên	Loại	Nội dung mô tả
attachments	BlobSource[]	một mảng tệp để gửi kèm theo email
bcc	String	danh sách được phân tách bằng dấu phẩy gồm các địa chỉ email gửi tới BCC
cc	String	danh sách địa chỉ email được phân tách bằng dấu phẩy
from	String	địa chỉ dùng để gửi email. Địa chỉ này phải là một trong những giá trị được getAliases() trả về
htmlBody	String	Nếu được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng HTML đó thay vì đối số nội dung bắt buộc; bạn có thể thêm một trường inlineImages không bắt buộc trong nội dung HTML nếu bạn có hình ảnh cùng dòng cho email của mình
inlineImages	Object	một đối tượng JavaScript chứa đường liên kết từ khoá hình ảnh (String) đến dữ liệu hình ảnh (BlobSource); thuộc tính này giả định rằng tham số htmlBody được sử dụng và chứa thông tin 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 phải được gửi từ một địa chỉ email chung không trả lời để ngăn người nhận trả lời email. Lựa chọn này chỉ áp dụng cho tài khoản Google Workspace, không phải 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)

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• sendEmail(recipient, subject, body)

---

setCurrentMessageAccessToken(accessToken)

Đặ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.

Chỉ các dự án Tiện ích bổ sung của Google Workspace sử dụng phạm vi thư hiện tại của Gmail mới yêu cầu phương thức này.

function handleAddonActionEvent(e) {
  var accessToken = e.messageMetadata.accessToken;
  var messageId = e.messageMetadata.messageId;
  GmailApp.setCurrentMessageAccessToken(accessToken);
  var mailMessage = GmailApp.getMessageById(messageId);
  // Do something with mailMessage
}

Thông số

Tên	Loại	Nội dung mô tả
accessToken	String	mã truy cập tạm thời lấy từ đối tượng sự kiện hành động của tiện ích bổ sung Gmail.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

starMessage(message)

Thêm một dấu sao vào thư này và buộc làm mới thư.

// Stars the first message in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
GmailApp.starMessage(message);

Thông số

Tên	Loại	Nội dung mô tả
message	GmailMessage	tin nhắn cần gắn dấu sao

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• starMessages(messages)

---

starMessages(messages)

Thêm dấu sao vào những thư này và buộc thư làm mới.

// Stars the first three messages in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.starMessages(coupleOfMessages);

Thông số

Tên	Loại	Nội dung mô tả
messages	GmailMessage[]	một loạt thư để gắn dấu sao

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• starMessage(message)

---

unstarMessage(message)

Xoá một dấu sao khỏi thư này và buộc thư làm mới.

// Unstars the first message in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
GmailApp.unstarMessage(message);

Thông số

Tên	Loại	Nội dung mô tả
message	GmailMessage	thư cần bỏ gắn dấu sao

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• unstarMessages(messages)

---

unstarMessages(messages)

Xoá dấu sao khỏi các thư này và buộc thư làm mới.

// Unstars the first three messages in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.unstarMessages(coupleOfMessages);

Thông số

Tên	Loại	Nội dung mô tả
messages	GmailMessage[]	một loạt các thư để bỏ gắn dấu sao

Hai chiều

GmailApp — dịch vụ Gmail, hữu ích cho việc tạo chuỗ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

Xem thêm

• unstarMessage(message)

Các phương thức ngừng hoạt động

getChatThreads()

Không dùng nữa. Hàm này không được dùng nữa và không được sử dụng trong tập lệnh mới.

Nhận tất cả chuỗi tin nhắn trên Google Hangouts phiên bản cũ và chuỗi tin nhắn trên Google Chat cho đến khi Google chuyển tất cả người dùng Hangouts phiên bản cũ sang Chat vào cuối năm nay. Để tìm hiểu thêm, hãy xem bài viết Tìm hiểu về việc chuyển từ Hangouts phiên bản cũ sang Google Chat.

Lệnh gọi này không thành công khi kích thước của tất cả các luồng quá lớn đến mức hệ thống không thể xử lý. Khi không xác định được kích thước luồng và có thể rất lớn, hãy sử dụng lệnh gọi "phân trang" và chỉ định phạm vi của luồng cần truy xuất trong mỗi lệnh gọi.

var threads = GmailApp.getChatThreads();
Logger.log("# of chat threads: " + threads.length);

Hai chiều

GmailThread[] – Một loạt chuỗi trò chuyện từ Gmail.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/

---

getChatThreads(start, max)

Không dùng nữa. Hàm này không được dùng nữa và không được sử dụng trong tập lệnh mới.

Nhận một loạt chuỗi tin nhắn trên Google Hangouts phiên bản cũ và các chuỗi tin nhắn trên Google Chat cho đến khi Google chuyển tất cả người dùng Hangouts phiên bản cũ sang Chat vào cuối năm nay. Để tìm hiểu thêm, hãy xem bài viết Tìm hiểu về việc chuyển từ Hangouts phiên bản cũ sang Google Chat.

// Get first 50 chat threads
var threads = GmailApp.getChatThreads(0,50);
// Will log no more than 50.0
Logger.log(threads.length);
Logger.log(threads[0].getFirstMessageSubject());

Thông số

Tên	Loại	Nội dung mô tả
start	Integer	chỉ mục của luồng đầu tiên cần truy xuất
max	Integer	số lượng chuỗi tối đa cần truy xuất

Hai chiều

GmailThread[] — một loạt các chuỗi trò chuyện trong Gmail

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

• https://mail.google.com/