Class GmailApp

GmailApp

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

Phương thức

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

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

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
getChatThreads()	GmailThread[]	Xem tất cả chuỗi tin nhắn trong Google Hangouts phiên bản cũ và chuỗi trò chuyện trong Google Chat cho đến khi Google chuyển đổi tất cả người dùng Hangouts phiên bản cũ sang Chat cuối năm nay.
getChatThreads(start, max)	GmailThread[]	Nhận loạt chuỗi tin nhắn trong Google Hangouts phiên bản cũ và chuỗi tin nhắn trong Google Chat cho đến khi Google chuyển đổi 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 email nháp. Kích thước của email (bao gồm cả phần thông tin thư) bị giới hạn hạn mức.

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

Tham 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 — Thư nháp mới được tạo trên Gmail

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• createDraft(recipient, subject, body, options)

---

createDraft(recipient, subject, body, options)

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

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

Tham 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	đố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 tệp để gửi cùng với email
bcc	String	danh sách địa chỉ email được phân tách bằng dấu phẩy tới BCC
cc	String	danh sách địa chỉ email được phân tách bằng dấu phẩy để gửi CC
from	String	địa chỉ email phải được gửi từ đó trong các giá trị được getAliases() trả về
htmlBody	String	nếu được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng HTML này của đố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 HTML nội dung nếu bạn có hình ảnh cùng dòng cho email của mình
inlineImages	Object	đối tượng JavaScript chứa ánh xạ từ khoá hình ảnh (String) thành dữ liệu hình ảnh (BlobSource); điều này giả định rằng tham số htmlBody được sử dụng và có chứa thông tin tham chiếu đến những hình ảnh này ở định dạng <img src="cid:imageKey" />
name	String	tên người gửi email (mặc định: tên của người dùng)
replyTo	String	địa chỉ email để sử 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 — Thư nháp mới được tạo trên Gmail

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• createDraft(recipient, subject, body)

---

createLabel(name)

Tạo một nhãn người dùng mới cho tên được cung cấp.

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

Tham 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 dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:

• https://mail.google.com/

Xem thêm

• deleteLabel(label)

---

deleteLabel(label)

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

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

Tham 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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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 email đại diện cho tài khoản này trong Gmail.

Bạn có thể gửi thư từ bất kỳ email đại diện nào trong số này bằng cách sử dụng mật khẩu "từ" đối số không bắt buộc.

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

Cầu thủ trả bóng

String[] — một loạt các bí danh cho tài khoản này

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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 thuộc tính này cùng với getId() trên thư nháp của Gmail.

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

Tham số

Tên	Loại	Mô tả
draftId	String	mã 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ã đã cho

Ủy quyền

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

• https://mail.google.com/

---

getDraftMessages()

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

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

Cầu thủ trả bóng

GmailMessage[] — một loạt các thư Gmail nháp

Ủy quyền

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

• https://mail.google.com/

---

getDrafts()

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

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

Cầu thủ trả bóng

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

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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à gì.

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

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

Cầu thủ trả bóng

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

Ủy quyền

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

• https://mail.google.com/

---

getInboxThreads(start, max)

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

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

Tham số

Tên	Loại	Mô tả
start	Integer	chỉ mục của chuỗi đầu tiê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 loạt các chuỗi thư Gmail trong Hộp thư đến

Ủy quyền

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

• https://mail.google.com/

---

getInboxUnreadCount()

Lấy số 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ố chuỗi trong hộp thư đến có thư chưa đọc

Ủy quyền

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

• https://mail.google.com/

---

getMessageById(id)

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

Sử dụng thuộc tính này cùng với getId() trên thư Gmail.

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

Tham 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ông báo nào có mã nhận dạng đã cho

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• getThreadById(id)

---

getMessagesForThread(thread)

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

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

Tham số

Tên	Loại	Mô tả
thread	GmailThread	chuỗi thư cần truy xuất

Cầu thủ trả bóng

GmailMessage[] – mảng tin nhắn tương ứng với chuỗi này

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• getMessagesForThreads(threads)

---

getMessagesForThreads(threads)

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

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

Tham 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 thông báo, 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 thông báo trong chuỗi đó

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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ực hiện được 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. Trong trường hợp kích thước chuỗi không xác định và có thể rất lớn, vui lòng sử dụng thuộc tính cuộc gọi và chỉ định phạm vi của 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 loạt các chuỗi thư Gmail trong Hộp thư ưu tiên

Ủy quyền

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

• https://mail.google.com/

---

getPriorityInboxThreads(start, max)

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

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

Tham số

Tên	Loại	Mô tả
start	Integer	chỉ mục của chuỗi đầu tiê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 loạt các chuỗi thư Gmail trong Hộp thư ưu tiên

Ủy quyền

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

• https://mail.google.com/

---

getPriorityInboxUnreadCount()

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

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

Cầu thủ trả bóng

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

Ủy quyền

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

• https://mail.google.com/

---

getSpamThreads()

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

Lệnh gọi này sẽ không thực hiện được khi kích thước của tất cả các luồng quá lớn, khiến hệ thống không xử lý được. Trong trường hợp kích thước chuỗi không xác định và có thể rất lớn, vui lòng sử dụng thuộc tính cuộc gọi và chỉ định phạm vi của 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 loạt các chuỗi email trên Gmail trong thư mục thư rác

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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 là gì.

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

Tham số

Tên	Loại	Mô tả
start	Integer	chỉ mục của chuỗi đầu tiê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 loạt các chuỗi email trên Gmail trong thư mục thư rác

Ủy quyền

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

• https://mail.google.com/

---

getSpamUnreadCount()

Lấy số lượng chuỗi tin nhắn rác chưa đọ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ố chuỗi tin nhắn rác có tin nhắn chưa đọc

Ủy quyền

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

• https://mail.google.com/

---

getStarredThreads()

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

Lệnh gọi này sẽ không thực hiện được khi kích thước của tất cả các luồng quá lớn, khiến hệ thống không xử lý được. Trong trường hợp kích thước chuỗi không xác định và có thể rất lớn, vui lòng sử dụng thuộc tính cuộc gọi và chỉ định phạm vi của 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 loạt các chuỗi thư Gmail có gắn dấu sao

Ủy quyền

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

• https://mail.google.com/

---

getStarredThreads(start, max)

Truy xuất một loạt chuỗi thư 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);

Tham số

Tên	Loại	Mô tả
start	Integer	chỉ mục của chuỗi đầu tiê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 loạt các chuỗi thư Gmail có gắn dấu sao

Ủy quyền

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

• https://mail.google.com/

---

getStarredUnreadCount()

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

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

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

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

• https://mail.google.com/

---

getThreadById(id)

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

Sử dụng thuộc tính này cùng với getId() trên các chuỗi 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());

Tham số

Tên	Loại	Mô tả
id	String	Mã nhận dạng 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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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à gì.

Lệnh gọi này sẽ không thực hiện được khi kích thước của tất cả các luồng quá lớn, khiến hệ thống không xử lý được. Trong trường hợp kích thước chuỗi không xác định và có thể rất lớn, vui lòng sử dụng thuộc tính cuộc gọi và chỉ định phạm vi của 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 loạt các chuỗi thư Gmail trong thùng rác

Ủy quyền

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

• https://mail.google.com/

---

getTrashThreads(start, max)

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

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

Tham số

Tên	Loại	Mô tả
start	Integer	chỉ mục của chuỗi đầu tiê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 loạt các chuỗi thư Gmail trong thùng rác

Ủy quyền

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

• https://mail.google.com/

---

getUserLabelByName(name)

Truy xuất nhãn đã cho tên nhãn.

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

Tham số

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

Cầu thủ trả bóng

GmailLabel — nhãn Gmail có tên được cung cấp

Ủy quyền

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

• https://mail.google.com/

---

getUserLabels()

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

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

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 dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:

• https://mail.google.com/

---

markMessageRead(message)

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

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

Tham 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

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

• https://mail.google.com/

Xem thêm

• markMessageUnread(message)

---

markMessageUnread(message)

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

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

Tham 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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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 cá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.
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesRead(thread.getMessages());

Tham số

Tên	Loại	Mô tả
messages	GmailMessage[]	một loạt thư để đá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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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 cá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
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesUnread(thread.getMessages());

Tham số

Tên	Loại	Mô tả
messages	GmailMessage[]	một loạt tin nhắ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

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

• https://mail.google.com/

Xem thêm

• markMessagesRead(messages)

---

markThreadImportant(thread)

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

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

Tham 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

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

• https://mail.google.com/

Xem thêm

• markThreadUnimportant(thread)

---

markThreadRead(thread)

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

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

Tham số

Tên	Loại	Mô tả
thread	GmailThread	chuỗi 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

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

• https://mail.google.com/

Xem thêm

• markThreadUnread(thread)

---

markThreadUnimportant(thread)

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

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

Tham số

Tên	Loại	Mô tả
thread	GmailThread	đánh dấu chuỗi 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

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

• https://mail.google.com/

Xem thêm

• markThreadImportant(thread)

---

markThreadUnread(thread)

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

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

Tham 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

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

• https://mail.google.com/

Xem thêm

• markThreadRead(thread)

---

markThreadsImportant(threads)

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

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

Tham số

Tên	Loại	Mô tả
threads	GmailThread[]	một mảng 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 tạo chuỗi

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• markThreadsUnimportant(threads)

---

markThreadsRead(threads)

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

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

Tham số

Tên	Loại	Mô tả
threads	GmailThread[]	một mảng chuỗi để đá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

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

• https://mail.google.com/

Xem thêm

• markThreadsUnread(threads)

---

markThreadsUnimportant(threads)

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

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

Tham số

Tên	Loại	Mô tả
threads	GmailThread[]	một mảng chuỗi để đá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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnread(threads);

Tham số

Tên	Loại	Mô tả
threads	GmailThread[]	một mảng chuỗi tin nhắ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

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

• https://mail.google.com/

Xem thêm

• markThreadsRead(threads)

---

moveMessageToTrash(message)

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

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

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

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• moveMessagesToTrash(messages)

---

moveMessagesToTrash(messages)

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

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

Tham số

Tên	Loại	Mô tả
messages	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 tạo chuỗi)

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• moveMessageToTrash(message)

---

moveThreadToArchive(thread)

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

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

Tham số

Tên	Loại	Mô tả
thread	GmailThread	chuỗi bài đăng sẽ được 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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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 phải làm mới.

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

Tham 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

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

• https://mail.google.com/

Xem thêm

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

---

moveThreadToSpam(thread)

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

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

Tham số

Tên	Loại	Mô tả
thread	GmailThread	chuỗi thư cần chuyển vào mục 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

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

• https://mail.google.com/

Xem thêm

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

---

moveThreadToTrash(thread)

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

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

Tham 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

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

• https://mail.google.com/

Xem thêm

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

---

moveThreadsToArchive(threads)

Di chuyển những luồng này đến kho lưu trữ và buộc các luồng làm mới.

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

Tham số

Tên	Loại	Mô tả
threads	GmailThread[]	một mảng 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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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
var firstTwoThreads = GmailApp.search("-in:inbox", 0, 2);
GmailApp.moveThreadsToInbox(firstTwoThreads);

Tham số

Tên	Loại	Mô tả
threads	GmailThread[]	một mảng chuỗi thư 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

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

• https://mail.google.com/

Xem thêm

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

---

moveThreadsToSpam(threads)

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

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

Tham số

Tên	Loại	Mô tả
threads	GmailThread[]	một loạt chuỗi thảo luận cần được chuyển vào phần 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

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

• https://mail.google.com/

Xem thêm

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

---

moveThreadsToTrash(threads)

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

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

Tham số

Tên	Loại	Mô tả
threads	GmailThread[]	một mảng luồng cần được 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

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

• https://mail.google.com/

Xem thêm

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

---

refreshMessage(message)

Tải lại thư và trạng thái liên kết từ Gmail (hữu ích trong trường hợp nhãn, trạng thái đọc, v.v. đã thay đổi).

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

Tham số

Tên	Loại	Mô tả
message	GmailMessage	tin nhắn cần được 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

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

• https://mail.google.com/

Xem thêm

• refreshMessages(messages)

---

refreshMessages(messages)

Tải lại thư và trạng thái được liên kết từ Gmail (hữu ích trong trường hợp nhãn, trạng thái đã đọc, v.v. đã thay đổi).

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

Tham số

Tên	Loại	Mô tả
messages	GmailMessage[]	tin nhắn cần được 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

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

• https://mail.google.com/

Xem thêm

• refreshMessage(message)

---

refreshThread(thread)

Tải lại chuỗi và trạng thái được liên kết từ Gmail (hữu ích trong trường hợp nhãn, trạng thái đọc, v.v. đã thay đổi).

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

Tham số

Tên	Loại	Mô tả
thread	GmailThread	chuỗi bài đăng sẽ được 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

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

• https://mail.google.com/

Xem thêm

• refreshThreads(threads)

---

refreshThreads(threads)

Tải lại các luồng và trạng thái được liên kết từ Gmail (hữu ích trong trường hợp nhãn, trạng thái đọc, v.v. đã thay đổi).

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

Tham 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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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 cụ thể.

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

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

Tham 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 loạt các chuỗi Gmail khớp với truy vấn này

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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 cụ thể.

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

Tham 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 chuỗi 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 loạt các chuỗi Gmail khớp với truy vấn này

Ủy quyền

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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ả phần thông tin thư) bị giới hạn hạn mức.

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

Tham 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 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

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

• https://mail.google.com/

Xem thêm

• sendEmail(recipient, subject, body, options)

---

sendEmail(recipient, subject, body, options)

Gửi email 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 HTML nội dung. Kích thước của email (bao gồm cả tiêu đề, nhưng không bao gồm tệp đính kèm) bị giới hạn.

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

Tham số

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

Thông số nâng cao

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

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

• https://mail.google.com/

Xem thêm

• sendEmail(recipient, subject, body)

---

setCurrentMessageAccessToken(accessToken)

Đặt thông báo hiện tại mã truy cập 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 của Google Workspace sử dụng phạm vi thư hiện tại trên Gmail yêu cầu phương thức này.

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

Tham 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 hành động của tiện ích bổ sung Gmail.

Ủy quyền

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

• https://mail.google.com/

---

starMessage(message)

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

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

Tham 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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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 làm mới thư.

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

Tham số

Tên	Loại	Mô tả
messages	GmailMessage[]	một loạt tin nhắ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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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 làm mới thư.

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

Tham số

Tên	Loại	Mô tả
message	GmailMessage	bỏ gắn dấu sao cho tin nhắ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

Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST 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 làm mới thư.

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

Tham số

Tên	Loại	Mô tả
messages	GmailMessage[]	một loạt 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

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

• https://mail.google.com/

Xem thêm

• unstarMessage(message)

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

getChatThreads()

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

Xem tất cả chuỗi tin nhắn trong Google Hangouts phiên bản cũ và chuỗi trò chuyện trong Google Chat cho đến khi Google chuyển đổi tất cả người dùng Hangouts phiên bản cũ sang Chat 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ực hiện được 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. Địa điểm kích thước chuỗi không xác định và có thể rất lớn, hãy sử dụng thuộc tính 'phân trang' gọi và chỉ định phạm vi luồng để truy xuất trong mỗi lệnh gọi.

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

Cầu thủ trả bóng

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

Ủy quyền

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

• https://mail.google.com/

---

getChatThreads(start, max)

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

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

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

Tham số

Tên	Loại	Mô tả
start	Integer	chỉ mục của chuỗi đầu tiê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 loạt các chuỗi trò chuyện trong Gmail

Ủy quyền

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

• https://mail.google.com/