Class GmailApp

Ứng dụngGmail

Cho phép 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 một nội dung email nháp.
createDraft(recipient, subject, body, options)	GmailDraft	Tạo nội dung email nháp với các đối số không bắt buộc.
createLabel(name)	GmailLabel	Tạo 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 các email được thiết lập làm địa chỉ email thay thế cho tài khoản này trong Gmail.
getDraft(draftId)	GmailDraft	Truy xuất nội dung email 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ả 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()	Integer	Lấy số lượng chuỗi tin nhắn chưa đọc trong hộp thư đến.
getMessageById(id)	GmailMessage	Nhậ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ư ư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()	Integer	Lấ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()	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ả 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()	Integer	Lấy số lượng chuỗi tin nhắn chưa đọc được gắn dấu sao.
getThreadById(id)	GmailThread|null	Lấ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)	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 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 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 này 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	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ư được chỉ định vào thùng rác và buộc các thư này làm mới.
moveThreadToArchive(thread)	GmailApp	Di chuyển chuỗi này vào kho lưu trữ và buộc chuỗi làm mới.
moveThreadToInbox(thread)	GmailApp	Di chuyển chuỗi này vào hộp thư đến và buộc chuỗi làm mới.
moveThreadToSpam(thread)	GmailApp	Di chuyển chuỗi này vào thư mục thư rác và buộc chuỗi làm mới.
moveThreadToTrash(thread)	GmailApp	Di 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 chuỗi này vào kho lưu trữ và buộc các chuỗi làm mới.
moveThreadsToInbox(threads)	GmailApp	Di 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)	GmailApp	Di chuyển các chuỗi này vào thư mục thư rác và buộc các chuỗi này làm mới.
moveThreadsToTrash(threads)	GmailApp	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)	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 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)	GmailApp	Tải lại chuỗ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).
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 nội dung email.
sendEmail(recipient, subject, body, options)	GmailApp	Gửi nội dung email 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 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 những 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 những thư này và buộc cá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[]	Lấy tất cả các chuỗi trong Google Hangouts phiên bản cũ và 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 các chuỗi tin nhắn trong Google Hangouts phiên bản cũ và 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 một nội dung email nháp. Kích thước của email (bao gồm cả phần đầu thư) là hạn mức giới hạn.

// The code below creates a draft email with the current date and time.
const now = new Date();
GmailApp.createDraft(
    '[e-mail]',
    'current time',
    `The time is: ${now.toString()}`,
);

Thông số

Tên	Loại	Mô tả
recipient	String	danh sách địa chỉ email được phân tách bằng dấu phẩy
subject	String	tiêu đề của email
body	String	nội dung email

Cầu thủ trả bóng

GmailDraft – GmailDraft mới tạo

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• createDraft(recipient, subject, body, options)

---

createDraft(recipient, subject, body, options)

Tạo nội dung email nháp 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 nội dung HTML. Kích thước của email (bao gồm cả phần đầu thư nhưng không bao gồm tệp đính kèm) là hạn mức giới hạn.

// Create a draft email with a file from Google Drive attached as a PDF.
const 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	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	một đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới

Thông số nâng cao

Tên	Loại	Mô tả
attachments	BlobSource[]	một mảng các tệp để gửi cùng email
bcc	String	danh sách địa chỉ email được phân tách bằng dấu phẩy để gửi BCC
cc	String	danh sách địa chỉ email được phân tách bằng dấu phẩy để thêm vào phần Cc
from	String	địa chỉ mà email sẽ được gửi từ đó, phải là một trong các giá trị do 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 tham số này thay vì đối số nội dung bắt buộc; bạn có thể thêm trường inlineImages không bắt buộc vào nội dung HTML nếu có hình ảnh nội dòng cho email
inlineImages	Object	một đối tượng JavaScript chứa một mối liên kết từ khoá hình ảnh (String) đến dữ liệu hình ảnh (BlobSource); điều này giả định rằng tham số htmlBody được dùng và chứa các tham chiếu đến những hình ảnh này ở định dạng <img src="cid:imageKey" />
name	String	tên của người gửi email (mặc định: tên của người dùng)
replyTo	String	địa chỉ email dùng làm địa chỉ trả lời mặc định (mặc định: địa chỉ email của người dùng)

Cầu thủ trả bóng

GmailDraft – GmailDraft mới tạo

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• createDraft(recipient, subject, body)

---

createLabel(name)

Tạo nhãn người dùng mới có tên đã cho.

// Creates the label @FOO and logs label: FOO
Logger.log(`label: ${GmailApp.createLabel('FOO')}`);

Thông số

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

Cầu thủ trả bóng

GmailLabel – nhãn mới tạo

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• deleteLabel(label)

---

deleteLabel(label)

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

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

Thông số

Tên	Loại	Mô tả
label	GmailLabel	nhãn cần xoá

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• createLabel(name)

---

getAliases()

Lấy danh sách các email được thiết lập làm địa chỉ email thay thế 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ố không bắt buộc "from".

// Log the aliases for this Gmail account and send an email as the first one.
const me = Session.getActiveUser().getEmail();
const 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.');
}

Cầu thủ trả bóng

String[] – một mảng gồm các biệt hiệu cho tài khoản này

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• sendEmail(recipient, subject, body, options)

---

getDraft(draftId)

Truy xuất nội dung email nháp theo mã nhận dạng.

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

// Get the first draft message in your drafts folder
const draft = GmailApp.getDrafts()[0];
// Get its ID
const draftId = draft.getId();
// Now fetch the same draft using that ID.
const 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	Mô tả
draftId	String	mã của bản nháp cần truy xuất

Cầu thủ trả bóng

GmailDraft – bản nháp có mã nhận dạng được chỉ định

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

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

• https://mail.google.com/

---

getDraftMessages()

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

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

Cầu thủ trả bóng

GmailMessage[] – một mảng gồm các thư nháp trên Gmail

Ủy quyền

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

• https://mail.google.com/

---

getDrafts()

Lấy tất cả thư nháp trong Gmail.

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

Cầu thủ trả bóng

GmailDraft[] – một mảng các thư nháp trên Gmail

Ủy quyền

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

• https://mail.google.com/

---

getInboxThreads()

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

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

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

Cầu thủ trả bóng

GmailThread[] – một mảng các chuỗi email trong hộp thư đến của Gmail

Ủy quyền

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

• https://mail.google.com/

---

getInboxThreads(start, max)

Truy xuất một dải các 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
const threads = GmailApp.getInboxThreads(0, 50);
for (let i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Thông số

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

Cầu thủ trả bóng

GmailThread[] – một mảng các chuỗi email trong hộp thư đến của Gmail

Ủy quyền

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

• https://mail.google.com/

---

getInboxUnreadCount()

Lấy số lượng chuỗi tin nhắn chưa đọc trong hộp thư đến.

Logger.log(`Messages unread in inbox: ${GmailApp.getInboxUnreadCount()}`);

Cầu thủ trả bóng

Integer – số lượng chuỗi tin nhắn trong hộp thư đến có tin nhắn chưa đọc

Ủy quyền

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

• https://mail.google.com/

---

getMessageById(id)

Nhận một thông báo theo mã nhận dạng.

Sử dụng phương thức này cùng với getId() trên thư trong Gmail.

// Get the first message in the first thread of your inbox
const message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
// Get its ID
const messageId = message.getId();
// Now fetch the same message using that ID.
const 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	Mô tả
id	String	mã nhận dạng của tin nhắn cần truy xuất

Cầu thủ trả bóng

GmailMessage – thư 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

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

• https://mail.google.com/

Xem thêm

• getThreadById(id)

---

getMessagesForThread(thread)

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

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

Thông số

Tên	Loại	Mô tả
thread	GmailThread	chuỗi tin nhắn cần truy xuất

Cầu thủ trả bóng

GmailMessage[] – mảng gồm các thông báo tương ứng với chuỗi này

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• getMessagesForThreads(threads)

---

getMessagesForThreads(threads)

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

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

Thông số

Tên	Loại	Mô tả
threads	GmailThread[]	các chuỗi tin nhắn cần truy xuất

Cầu thủ trả bóng

GmailMessage[][] – một mảng gồm các mảng tin nhắn, trong đó mỗi mục trong mảng bên ngoài tương ứng với một luồng và mảng bên trong chứa các tin nhắn trong luồng đó

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• getMessagesForThread(thread)

---

getPriorityInboxThreads()

Truy xuất tất cả cá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ành công khi kích thước của tất cả các luồng quá lớn để hệ thống xử lý. Khi không biết kích thước của luồng và có khả năng rất lớn, vui lòng sử dụng lệnh gọi "được phân trang" và chỉ định các dải luồng cần truy xuất trong mỗi lệnh gọi.

Logger.log(
    `# of messages in your Priority Inbox: ${
        GmailApp.getPriorityInboxThreads().length}`,
);

Cầu thủ trả bóng

GmailThread[] – một mảng các chuỗi email trong Gmail trong Hộp thư ưu tiên

Ủy quyền

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

• https://mail.google.com/

---

getPriorityInboxThreads(start, max)

Truy xuất một dải các chuỗi thư 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	Mô tả
start	Integer	chỉ mục của chuỗi đầu tiên cần truy xuất
max	Integer	số lượng luồng tối đa cần truy xuất

Cầu thủ trả bóng

GmailThread[] – một mảng các chuỗi email trong Gmail trong Hộp thư ưu tiên

Ủy quyền

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

• https://mail.google.com/

---

getPriorityInboxUnreadCount()

Lấy số lượng chuỗi chưa đọc trong Hộp thư ưu tiên.

Logger.log(
    `Number of unread emails in your Priority Inbox : ${
        GmailApp.getPriorityInboxUnreadCount()}`,
);

Cầu thủ trả bóng

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

Ủy quyền

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

• https://mail.google.com/

---

getSpamThreads()

Truy xuất tất cả các chuỗi tin nhắn rác bất kể nhãn.

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

Logger.log(`# of total spam threads: ${GmailApp.getSpamThreads().length}`);

Cầu thủ trả bóng

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

Ủy quyền

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

• https://mail.google.com/

---

getSpamThreads(start, max)

Truy xuất một dải các 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	Mô tả
start	Integer	chỉ mục của chuỗi đầu tiên cần truy xuất
max	Integer	số lượng luồng tối đa cần truy xuất

Cầu thủ trả bóng

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

Ủy quyền

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

• https://mail.google.com/

---

getSpamUnreadCount()

Lấy số lượng chuỗi tin nhắn chưa đọc là thư 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()}`);

Cầu thủ trả bóng

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

Ủy quyền

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

• https://mail.google.com/

---

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ành công khi kích thước của tất cả các luồng quá lớn để hệ thống xử lý. Khi không biết kích thước của luồng và có khả năng rất lớn, vui lòng sử dụng lệnh gọi "được phân trang" và chỉ định các dải luồng cần truy xuất trong mỗi lệnh gọi.

// Logs the number of starred threads
Logger.log(`# Starred threads: ${GmailApp.getStarredThreads().length}`);

Cầu thủ trả bóng

GmailThread[] – một mảng các chuỗi email được gắn dấu sao trong Gmail

Ủy quyền

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

• https://mail.google.com/

---

getStarredThreads(start, max)

Truy xuất một dải các 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	Mô tả
start	Integer	chỉ mục của chuỗi đầu tiên cần truy xuất
max	Integer	số lượng luồng tối đa cần truy xuất

Cầu thủ trả bóng

GmailThread[] – một mảng các chuỗi email được gắn dấu sao trong Gmail

Ủy quyền

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

• https://mail.google.com/

---

getStarredUnreadCount()

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

Logger.log(`# unread and starred: ${GmailApp.getStarredUnreadCount()}`);

Cầu thủ trả bóng

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

Ủy quyền

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

• https://mail.google.com/

---

getThreadById(id)

Lấy một luồng theo mã nhận dạng.

Sử dụng phương thức này cùng với getId() trên các chuỗi email 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	Mô tả
id	String	Mã của luồng cần truy xuất.

Cầu thủ trả bóng

GmailThread|null – Luồng có mã nhận dạng đã cho hoặc null nếu không tìm thấy.

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• getMessageById(id)

---

getTrashThreads()

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

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

Logger.log(`# of total trash threads: ${GmailApp.getTrashThreads().length}`);

Cầu thủ trả bóng

GmailThread[] – một mảng các chuỗi email trong thùng rác của Gmail

Ủy quyền

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

• https://mail.google.com/

---

getTrashThreads(start, max)

Truy xuất một dải các chuỗi trong 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	Mô tả
start	Integer	chỉ mục của chuỗi đầu tiên cần truy xuất
max	Integer	số lượng luồng tối đa cần truy xuất

Cầu thủ trả bóng

GmailThread[] – một mảng các chuỗi email trong thùng rác của Gmail

Ủy quyền

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

• https://mail.google.com/

---

getUserLabelByName(name)

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

const labelObject = GmailApp.getUserLabelByName('myLabel');

Thông số

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

Cầu thủ trả bóng

GmailLabel – nhãn Gmail có tên được chỉ định

Ủy quyền

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

• https://mail.google.com/

---

getUserLabels()

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

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

Cầu thủ trả bóng

GmailLabel[] – mảng nhãn do người dùng tạo

Ủy quyền

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

• https://mail.google.com/

---

markMessageRead(message)

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

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

Thông số

Tên	Loại	Mô tả
message	GmailMessage	thư cần đánh dấu là đã đọc

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• markMessageUnread(message)

---

markMessageUnread(message)

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

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

Thông số

Tên	Loại	Mô tả
message	GmailMessage	thư cần đánh dấu là chưa đọc

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• markMessageRead(message)

---

markMessagesRead(messages)

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

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

Thông số

Tên	Loại	Mô tả
messages	GmailMessage[]	một mảng gồm các thông báo cần đánh dấu là đã đọc

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• markMessagesUnread(messages)

---

markMessagesUnread(messages)

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

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

Thông số

Tên	Loại	Mô tả
messages	GmailMessage[]	một mảng gồm các thư cần đánh dấu là chưa đọc

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• markMessagesRead(messages)

---

markThreadImportant(thread)

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

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

Thông số

Tên	Loại	Mô tả
thread	GmailThread	chuỗi cần đánh dấu là quan trọng

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• 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
const thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadRead(thread);

Thông số

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

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• markThreadUnread(thread)

---

markThreadUnimportant(thread)

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

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

Thông số

Tên	Loại	Mô tả
thread	GmailThread	chuỗi tin nhắn cần đánh dấu là không quan trọng

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• 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
const thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnread(thread);

Thông số

Tên	Loại	Mô tả
thread	GmailThread	chuỗi cần đánh dấu là chưa đọc

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• markThreadRead(thread)

---

markThreadsImportant(threads)

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

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

Thông số

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

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• markThreadsUnimportant(threads)

---

markThreadsRead(threads)

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

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

Thông số

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

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• markThreadsUnread(threads)

---

markThreadsUnimportant(threads)

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

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

Thông số

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

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• 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
const threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnread(threads);

Thông số

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

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• markThreadsRead(threads)

---

moveMessageToTrash(message)

Di 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const firstMessage = firstThread.getMessages()[0];
GmailApp.moveMessageToTrash(firstMessage);

Thông số

Tên	Loại	Mô tả
message	GmailMessage	thư sẽ bị chuyển vào thùng rác

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail (hữu ích cho việc liên kết)

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• moveMessagesToTrash(messages)

---

moveMessagesToTrash(messages)

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

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

Thông số

Tên	Loại	Mô tả
messages	GmailMessage[]	những thư cần chuyển vào thùng rác

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail (hữu ích cho việc liên kết)

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• moveMessageToTrash(message)

---

moveThreadToArchive(thread)

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

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

Thông số

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

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

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

---

moveThreadToInbox(thread)

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

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

Thông số

Tên	Loại	Mô tả
thread	GmailThread	chuỗi bài đăng cần chuyển vào hộp thư đến

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

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

---

moveThreadToSpam(thread)

Di chuyển chuỗi này vào thư mục thư rác và buộc chuỗi làm mới.

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

Thông số

Tên	Loại	Mô tả
thread	GmailThread	chuỗi cần chuyển vào thư mục nội dung rác

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

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

---

moveThreadToTrash(thread)

Di 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.moveThreadToTrash(firstThread);

Thông số

Tên	Loại	Mô tả
thread	GmailThread	chuỗi cần chuyển vào thùng rác

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

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

---

moveThreadsToArchive(threads)

Di 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.

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

Thông số

Tên	Loại	Mô tả
threads	GmailThread[]	một mảng các luồng cần lưu trữ

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

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

---

moveThreadsToInbox(threads)

Di 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.

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

Thông số

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

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

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

---

moveThreadsToSpam(threads)

Di chuyển các chuỗi này vào thư mục thư rác và buộc các chuỗi này làm mới.

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

Thông số

Tên	Loại	Mô tả
threads	GmailThread[]	một mảng các chuỗi cần chuyển vào thư mục thư rác

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

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

---

moveThreadsToTrash(threads)

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.

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

Thông số

Tên	Loại	Mô tả
threads	GmailThread[]	một mảng các luồng sẽ bị xoá vào thùng rác

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• 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).

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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	Mô tả
message	GmailMessage	thông báo cần làm mới

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• refreshMessages(messages)

---

refreshMessages(messages)

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

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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	Mô tả
messages	GmailMessage[]	các thông báo cần làm mới

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• refreshMessage(message)

---

refreshThread(thread)

Tải lại chuỗ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).

const 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	Mô tả
thread	GmailThread	chuỗi cần làm mới

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• 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).

const 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	Mô tả
threads	GmailThread[]	các chuỗi cần làm mới

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• 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ành công khi kích thước của tất cả các luồng quá lớn để hệ thống xử lý. Khi không biết kích thước của luồng và có khả năng rất lớn, vui lòng sử dụng lệnh gọi "được phân trang" và chỉ định các dải luồng cần truy xuất trong mỗi lệnh gọi.

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

Thông số

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

Cầu thủ trả bóng

GmailThread[] – một mảng các chuỗi thư trên Gmail phù hợp với truy vấn này

Ủy quyền

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

• https://mail.google.com/

---

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.
const threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);

Thông số

Tên	Loại	Mô tả
query	String	cụm từ tìm kiếm, giống như cách 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ề

Cầu thủ trả bóng

GmailThread[] – một mảng các chuỗi thư trên Gmail phù hợp với truy vấn này

Ủy quyền

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

• https://mail.google.com/

---

sendEmail(recipient, subject, body)

Gửi nội dung email. Kích thước của email (bao gồm cả phần đầu thư) là hạn mức giới hạn.

// The code below will send an email with the current date and time.
const now = new Date();
GmailApp.sendEmail(
    '[e-mail]',
    'current time',
    `The time is: ${now.toString()}`,
);

Thông số

Tên	Loại	Mô tả
recipient	String	danh sách địa chỉ email được phân tách bằng dấu phẩy
subject	String	tiêu đề của email (tối đa 250 ký tự)
body	String	nội dung email

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• sendEmail(recipient, subject, body, options)

---

sendEmail(recipient, subject, body, options)

Gửi nội dung email 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 cả phần đầu thư nhưng không bao gồm tệp đính kèm) là hạn mức giới hạn.

// Send an email with a file from Google Drive attached as a PDF.
const 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	Mô tả
recipient	String	địa chỉ của người nhận
subject	String	dòng tiêu đề (tối đa 250 ký tự)
body	String	nội dung email
options	Object	một đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới

Thông số nâng cao

Tên	Loại	Mô tả
attachments	BlobSource[]	một mảng các tệp để gửi cùng email
bcc	String	danh sách địa chỉ email được phân tách bằng dấu phẩy để gửi BCC
cc	String	danh sách địa chỉ email được phân tách bằng dấu phẩy để thêm vào phần Cc
from	String	địa chỉ mà email sẽ được gửi từ đó, phải là một trong các giá trị do 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 tham số này thay vì đối số nội dung bắt buộc; bạn có thể thêm trường inlineImages không bắt buộc vào nội dung HTML nếu có hình ảnh nội dòng cho email
inlineImages	Object	một đối tượng JavaScript chứa một mối liên kết từ khoá hình ảnh (String) đến dữ liệu hình ảnh (BlobSource); điều này giả định rằng tham số htmlBody được dùng và chứa các tham chiếu đến những hình ảnh này ở định dạng <img src="cid:imageKey" />
name	String	tên của người gửi email (mặc định: tên của người dùng)
noReply	Boolean	true nếu email được gửi từ một địa chỉ email chung không dùng để trả lời nhằm ngăn người nhận trả lời email; lựa chọn này chỉ dành cho tài khoản Google Workspace, không dành cho người dùng Gmail
replyTo	String	địa chỉ email dùng làm địa chỉ trả lời mặc định (mặc định: địa chỉ email của người dùng)

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• 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ỉ những dự án tiện ích bổ sung Google Workspace sử dụng các phạm vi thông báo hiện tại của Gmail mới yêu cầu phương thức này.

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

Thông số

Tên	Loại	Mô tả
accessToken	String	mã truy cập tạm thời nhận được từ đối tượng sự kiện thao tác của tiện ích bổ sung dành cho Gmail.

Ủy quyền

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

• https://mail.google.com/

---

starMessage(message)

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

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

Thông số

Tên	Loại	Mô tả
message	GmailMessage	thư cần gắn dấu sao

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.starMessages(coupleOfMessages);

Thông số

Tên	Loại	Mô tả
messages	GmailMessage[]	một mảng gồm các tin nhắn cần gắn dấu sao

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• starMessage(message)

---

unstarMessage(message)

Xoá 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
GmailApp.unstarMessage(message);

Thông số

Tên	Loại	Mô tả
message	GmailMessage	tin nhắn cần bỏ gắn dấu sao

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• unstarMessages(messages)

---

unstarMessages(messages)

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

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

Thông số

Tên	Loại	Mô tả
messages	GmailMessage[]	một mảng các tin nhắn cần bỏ gắn dấu sao

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• 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òn được dùng nữa và bạn không nên sử dụng trong các tập lệnh mới.

Lấy tất cả các chuỗi trong Google Hangouts phiên bản cũ và 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 sẽ không thành công khi kích thước của tất cả các luồng quá lớn để hệ thống xử lý. Khi kích thước luồng không xác định và có thể rất lớn, hãy sử dụng lệnh gọi "được phân trang" và chỉ định các dải luồng cần truy xuất trong mỗi lệnh gọi.

const threads = GmailApp.getChatThreads();
Logger.log(`# of chat threads: ${threads.length}`);

Cầu thủ trả bóng

GmailThread[] – Một mảng các chuỗi trò chuyện trong Gmail.

Ủy quyền

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

• https://mail.google.com/

---

getChatThreads(start, max)

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

Nhận một loạt các chuỗi tin nhắn trên Google Hangouts phiên bản cũ và 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
const 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	Mô tả
start	Integer	chỉ mục của chuỗi đầu tiên cần truy xuất
max	Integer	số lượng luồng tối đa cần truy xuất

Cầu thủ trả bóng

GmailThread[] – một mảng các chuỗi trò chuyện trên Gmail

Ủy quyền

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

• https://mail.google.com/