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

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à 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à 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 đề) bị giới hạn theo hạn mức.

// 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 của email

Cầu thủ trả bóng

GmailDraft – GmailDraft mới tạo

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 một thư email nháp có 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) bị giới hạn theo hạn mức.

// 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 của 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 آرایه 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ỉ gửi email, phải là một trong các giá trị mà getAliases() trả về
htmlBody	String	nếu được đặt, các thiết bị có thể hiển thị HTML sẽ sử dụng thuộc tính 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 trong nội dung HTML nếu đã thêm hình ảnh nội tuyến cho email
inlineImages	Object	một đối tượng JavaScript chứa mối liên kết từ khoá hình ảnh (String) đến dữ liệu hình ảnh (BlobSource); giả định rằng tham số htmlBody được sử dụng và chứa các tệp tham chiếu đến các 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

Các tập lệnh sử dụng phương thức này yêu cầu 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

Các tập lệnh sử dụng phương thức này yêu cầu 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 email được thiết lập làm bí danh cho tài khoản này trong Gmail.

Bạn có thể gửi tin nhắn từ bất kỳ bí danh nào trong số này bằng cách sử dụng đối số "from" (từ).

// 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 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 yêu cầu 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 thư nháp theo mã nhận dạng.

Sử dụng hàm 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ã nhận dạng 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 đã cho

Gửi

Error – nếu không tìm thấy bản nháp nào có mã đã cung cấp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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

Các tập lệnh sử dụng phương thức này yêu cầu 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 trên 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 gồm các thư nháp trên Gmail

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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ả chuỗi thư 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 khiến hệ thống không xử lý được. 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 của các 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 gồm 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 yêu cầu 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 chuỗi thư 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 luồng đầu tiên cần truy xuất
max	Integer	số lượng luồng tối đa để truy xuất

Cầu thủ trả bóng

GmailThread[] – một mảng gồm 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 yêu cầu 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 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 yêu cầu 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)

Lấy thông báo theo mã nhận dạng.

Sử dụng hàm này cùng với getId() trên thư 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 thư cần truy xuất

Cầu thủ trả bóng

GmailMessage – thông báo có mã nhận dạng đã cho

Gửi

Error – nếu không tìm thấy thư có mã đã cung cấp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 tin nhắn tương ứng với chuỗi tin nhắn này

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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[]	chuỗi tin nhắn cần truy xuất

Cầu thủ trả bóng

GmailMessage[][] – một mảng 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

Các tập lệnh sử dụng phương thức này yêu cầu 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ả chuỗi thư trong Hộp thư đến ư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 khiến hệ thống không xử lý được. 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 của các 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 gồm các chuỗi thư trong 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 yêu cầu 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 loạt 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 luồng đầu tiên cần truy xuất
max	Integer	số lượng luồng tối đa để truy xuất

Cầu thủ trả bóng

GmailThread[] – một mảng gồm các chuỗi thư trong 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 yêu cầu 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 thư 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 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 yêu cầu 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ả chuỗi thư 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 khiến hệ thống không xử lý được. 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 của các 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 gồm các chuỗi thư trên 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 yêu cầu 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 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	Mô tả
start	Integer	chỉ mục của luồng đầu tiên cần truy xuất
max	Integer	số lượng luồng tối đa để truy xuất

Cầu thủ trả bóng

GmailThread[] – một mảng gồm các chuỗi thư trên 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 yêu cầu đượ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 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 yêu cầu 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ả chuỗi tin nhắn đượ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 khiến hệ thống không xử lý được. 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 của các 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 gồm các 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 yêu cầu 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 loạt chuỗi tin nhắn đượ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 luồng đầu tiên cần truy xuất
max	Integer	số lượng luồng tối đa để truy xuất

Cầu thủ trả bóng

GmailThread[] – một mảng gồm các 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 yêu cầu 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 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 yêu cầu 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 luồng theo mã nhận dạng.

Sử dụng hà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	Mô tả
id	String	Mã của luồng cần truy xuất.

Cầu thủ trả bóng

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 yêu cầu 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ả chuỗi thư 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 khiến hệ thống không xử lý được. 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 của các 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 gồm các chuỗi thư trong Gmail ở thùng rác

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 loạt chuỗi thư 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 luồng đầu tiên cần truy xuất
max	Integer	số lượng luồng tối đa để truy xuất

Cầu thủ trả bóng

GmailThread[] – một mảng gồm các chuỗi thư trong Gmail ở thùng rác

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 một nhãn dựa trên 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 đã cho

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 các 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 yêu cầu 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 làm mới tin nhắn.

// 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 tin nhắn này là chưa đọc và buộc làm mới tin nhắn.

// 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 các thư này là đã đọc và buộc làm mới các thư.

// 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 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 thông báo 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 này 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 thư 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 này 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 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 này 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 này 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 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 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
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 luồng 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 tin nhắn này là đã đọc và buộc các chuỗi tin nhắn đó 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 luồng cần đánh dấu là đã đọc

Cầu thủ trả bóng

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 yêu cầu 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 chuỗi 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 này 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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ư 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 tạo chuỗi)

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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ư đã chỉ định vào thùng rác và buộc làm mới các thư đó.

// 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[]	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 tạo chuỗi)

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 luồng này vào kho lưu trữ và buộc luồng này 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 thư này vào hộp thư đến và buộc chuỗi thư 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 thư 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 thư này sang thư rác và buộc chuỗi thư 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 tin nhắn cần chuyển vào mục nội dung rác

Cầu thủ trả bóng

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 yêu cầu 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 tin nhắn này vào thùng rác và buộc chuỗi tin nhắn 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 luồng này vào bản lưu trữ và buộc các luồng 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 chuỗi cần lưu trữ

Cầu thủ trả bóng

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 yêu cầu 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 thư này vào hộp thư đến và buộc các chuỗi thư 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 tin nhắn 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 tin nhắn này sang thư rác và buộc các chuỗi tin nhắn 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 luồng sẽ được chuyển sang thư rác

Cầu thủ trả bóng

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 yêu cầu 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)

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

// 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 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 (rất 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 kết từ Gmail (rất hữu ích trong trường hợp nhãn, trạng thái đã đọc, v.v. đã thay đổi).

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[]	tin nhắn cần làm mới

Cầu thủ trả bóng

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 yêu cầu 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 luồng và trạng thái liên kết từ Gmail (rất hữu ích trong trường hợp nhãn, trạng thái đã đọc, v.v. đã thay đổi).

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	luồng cần làm mới

Cầu thủ trả bóng

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 yêu cầu 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 thư và trạng thái liên kết từ Gmail (rất hữu ích trong trường hợp các nhãn, trạng thái đã đọc, v.v. đã thay đổi).

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 luồng cần làm mới

Cầu thủ trả bóng

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 yêu cầu 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 khiến hệ thống không xử lý được. 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 của các 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, như khi 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 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 yêu cầu 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, 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ề

Cầu thủ trả bóng

GmailThread[] – một mảng các chuỗi thư trên 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 yêu cầu 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 email. Kích thước của email (bao gồm cả tiêu đề) bị giới hạn theo hạn mức.

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

Cầu thủ trả bóng

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 yêu cầu 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 email có đối số tuỳ chọn. 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) bị giới hạn theo hạn mức.

// 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 của 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 آرایه 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ỉ gửi email, phải là một trong các giá trị mà getAliases() trả về
htmlBody	String	nếu được đặt, các thiết bị có thể hiển thị HTML sẽ sử dụng thuộc tính 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 trong nội dung HTML nếu đã thêm hình ảnh nội tuyến cho email
inlineImages	Object	một đối tượng JavaScript chứa mối liên kết từ khoá hình ảnh (String) đến dữ liệu hình ảnh (BlobSource); giả định rằng tham số htmlBody được sử dụng và chứa các tệp tham chiếu đến các 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 trả lời để người nhận không trả lời email; tuỳ chọn này chỉ dành cho tài khoản Google Workspace, chứ 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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ã thông báo truy cập hiện tại cho phép tập lệnh truy cập vào các thuộc tính GmailMessage hiện tại.

Chỉ các dự án tiện ích bổ sung 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) {
  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ã thông báo truy cập tạm thời được 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 yêu cầu 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	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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 các 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 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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 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
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 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 tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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à không nên được sử dụng trong các 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à 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 khiến hệ thống không xử lý được. 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 "đã phân trang" và chỉ định phạm vi của các 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 từ Gmail.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu 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à không nên được sử dụng trong các 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à 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 luồng đầu tiên cần truy xuất
max	Integer	số lượng luồng tối đa để 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

Các tập lệnh sử dụng phương thức này yêu cầu 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/