Class GmailThread

GmailThread

Một chuỗi trong tài khoản Gmail của người dùng.

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
addLabel(label)	GmailThread	Thêm nhãn này vào chuỗi.
createDraftReply(body)	GmailDraft	Tạo một thư nháp để trả lời người gửi tin nhắn gần đây nhất trong chuỗi này bằng địa chỉ trả lời.
createDraftReply(body, options)	GmailDraft	Tạo một thư nháp để trả lời người gửi tin nhắn gần đây nhất trong chuỗi này bằng địa chỉ trả lời, kèm theo các đối số không bắt buộc.
createDraftReplyAll(body)	GmailDraft	Tạo một thư nháp để trả lời người gửi thư gần đây nhất trong chuỗi thư này, bằng cách sử dụng địa chỉ trả lời và tất cả người nhận của thư này.
createDraftReplyAll(body, options)	GmailDraft	Tạo một thư nháp để trả lời người gửi thư cuối cùng trong chuỗi này, sử dụng địa chỉ trả lời và tất cả người nhận, có đối số không bắt buộc.
getFirstMessageSubject()	String	Lấy tiêu đề của tin nhắn đầu tiên trong chuỗi.
getId()	String	Lấy mã nhận dạng của luồng này.
getLabels()	GmailLabel[]	Trả về các nhãn do người dùng tạo trên luồng này.
getLastMessageDate()	Date	Lấy ngày của tin nhắn gần đây nhất trong chuỗi này.
getMessageCount()	Integer	Trả về số lượng tin nhắn trong chuỗi trò chuyện.
getMessages()	GmailMessage[]	Lấy các thư trong chuỗi thư này.
getPermalink()	String	Lấy một đường liên kết cố định cho chuỗi này.
hasStarredMessages()	Boolean	Trả về xem chuỗi có tin nhắn được gắn dấu sao hay không.
isImportant()	Boolean	Trả về cho dù chuỗi có được đánh dấu là quan trọng hay không.
isInChats()	Boolean	Trả về cho dù chuỗi có được gắn nhãn là cuộc trò chuyện hay không.
isInInbox()	Boolean	Trả về việc chuỗi có nằm trong hộp thư đến hay không.
isInPriorityInbox()	Boolean	Trả về true nếu chuỗi thư này nằm trong hộp thư đến ưu tiên; trả về false trong trường hợp ngược lại.
isInSpam()	Boolean	Trả về xem chuỗi có bị đánh dấu là nội dung rác hay không.
isInTrash()	Boolean	Trả về trạng thái của chuỗi hội thoại (có nằm trong thùng rác hay không).
isUnread()	Boolean	Trả về liệu chuỗi có tin nhắn chưa đọc hay không.
markImportant()	GmailThread	Đánh dấu chuỗi này là quan trọng.
markRead()	GmailThread	Đánh dấu chuỗi này là đã đọc.
markUnimportant()	GmailThread	Đánh dấu chuỗi này là không quan trọng.
markUnread()	GmailThread	Đánh dấu chuỗi này là chưa đọc.
moveToArchive()	GmailThread	Chuyển chuỗi này vào kho lưu trữ.
moveToInbox()	GmailThread	Chuyển chuỗi này vào hộp thư đến.
moveToSpam()	GmailThread	Chuyển chuỗi tin nhắn này vào thư mục thư rác.
moveToTrash()	GmailThread	Chuyển chuỗi tin nhắn này vào thùng rác.
refresh()	GmailThread	Tải lại chuỗi này 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).
removeLabel(label)	GmailThread	Xoá nhãn này khỏi chuỗi thư.
reply(body)	GmailThread	Trả lời người gửi tin nhắn gần đây nhất trong chuỗi này bằng địa chỉ replyTo.
reply(body, options)	GmailThread	Trả lời người gửi thư cuối cùng trong chuỗi thư này bằng địa chỉ replyTo, có thể có các đối số.
replyAll(body)	GmailThread	Trả lời người gửi (bằng địa chỉ replyTo) và tất cả người nhận của thư cuối cùng trong chuỗi thư này.
replyAll(body, options)	GmailThread	Trả lời người gửi (bằng địa chỉ replyTo) và tất cả người nhận của thư cuối cùng trong chuỗi thư này, có thể kèm theo các đối số không bắt buộc.

Tài liệu chi tiết

addLabel(label)

Thêm nhãn này vào chuỗi.

// Add label MyLabel to the first thread in the inbox
const label = GmailApp.getUserLabelByName('MyLabel');
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.addLabel(label);

Tham số

Tên	Loại	Mô tả
label	GmailLabel	nhãn cần áp dụng cho chuỗi này

Cầu thủ trả bóng

GmailThread – chuỗi này, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• removeLabel(label)

---

createDraftReply(body)

Tạo một thư nháp để trả lời người gửi tin nhắn gần đây nhất trong chuỗi này bằng địa chỉ trả lời. Kích thước của email (bao gồm cả phần đầu thư) đã vượt quá hạn mức.

// Create a draft reply to the message author with an acknowledgement.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.createDraftReply('Got your message');

Tham số

Tên	Loại	Mô tả
body	String	nội dung email

Cầu thủ trả bóng

GmailDraft – thư nháp mới tạo

Ủy quyền

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

• reply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

---

createDraftReply(body, options)

Tạo một thư nháp để trả lời người gửi tin nhắn gần đây nhất trong chuỗi này bằng địa chỉ trả lời, kèm theo các đối số không bắt buộc.

Email có thể chứa cả văn bản thuần tuý và nội dung HTML. Kích thước của email (bao gồm cả tiêu đề) đã vượt quá hạn mức.

// Create a draft response with an HTML text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.createDraftReply('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: '[e-mail]',
});

Tham số

Tên	Loại	Mô tả
body	String	nội dung email
options	Object	một đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới

Thông số nâng cao

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

Cầu thủ trả bóng

GmailDraft – thư nháp mới tạo

Ủy quyền

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

• reply(body, options)
• createDraftReply(body)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

---

createDraftReplyAll(body)

Tạo một thư nháp để trả lời người gửi thư gần đây nhất trong chuỗi thư này, bằng cách sử dụng địa chỉ trả lời và tất cả người nhận của thư này. Kích thước của email (bao gồm cả phần đầu thư) bị giới hạn về hạn mức.

// Create a draft reply to all recipients (except those bcc'd) of the last email
// in this thread.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.createDraftReplyAll('Got your message');

Tham số

Tên	Loại	Mô tả
body	String	nội dung email

Cầu thủ trả bóng

GmailDraft – thư nháp mới tạo

Ủy quyền

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

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body, options)

---

createDraftReplyAll(body, options)

Tạo một thư nháp để trả lời người gửi thư cuối cùng trong chuỗi này, sử dụng địa chỉ trả lời và tất cả người nhận, có đối số không bắt buộc.

Email có thể chứa cả văn bản thuần tuý và nội dung HTML. Kích thước của email (bao gồm cả tiêu đề) đã vượt quá hạn mức.

// Create a draft reply, using an HTML text body, to all recipients (except
// those bcc'd) of the last email of in this thread.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.createDraftReplyAll('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: '[e-mail]',
});

Tham số

Tên	Loại	Mô tả
body	String	nội dung email
options	Object	một đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới

Thông số nâng cao

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

Cầu thủ trả bóng

GmailDraft – thư nháp mới tạo

Ủy quyền

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

• replyAll(body, options)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)

---

getFirstMessageSubject()

Lấy tiêu đề của tin nhắn đầu tiên trong chuỗi.

// Log the subject of the first message in the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(firstThread.getFirstMessageSubject());

Cầu thủ trả bóng

String – tiêu đề của tin nhắn đầu tiên trong chuỗi

Ủy quyền

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

• getLastMessageDate()

---

getId()

Lấy mã nhận dạng của luồng này. Mã nhận dạng của một chuỗi thay đổi tuỳ theo các thông báo mà chuỗi đó chứa; để có mã nhận dạng nhất quán cho một thông báo cụ thể trong chuỗi, hãy gọi getMessages()[0].getId().

// Log the subject of the first message in the first thread in the inbox.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const id = firstThread.getId();
// Get same thread by its ID.
const thread = GmailApp.getThreadById(id);
Logger.log(
    thread.getFirstMessageSubject() === firstThread.getFirstMessageSubject(),
);  // True

Cầu thủ trả bóng

String – mã nhận dạng của chuỗi này

---

getLabels()

Trả về các nhãn do người dùng tạo trên luồng này.

// Log the names of the labels attached to the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const labels = firstThread.getLabels();
for (let i = 0; i < labels.length; i++) {
  Logger.log(labels[i].getName());
}

Cầu thủ trả bóng

GmailLabel[] – một mảng nhãn cho chuỗi này

Ủy quyền

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

---

getLastMessageDate()

Lấy ngày của tin nhắn gần đây nhất trong chuỗi này.

// Log the date of the most recent message on the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(firstThread.getLastMessageDate());

Cầu thủ trả bóng

Date – ngày của tin nhắn gần đây nhất trong chuỗi

Ủy quyền

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

• getFirstMessageSubject()

---

getMessageCount()

Trả về số lượng tin nhắn trong chuỗi trò chuyện.

// Log the number of messages in the thread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(firstThread.getMessageCount());

Cầu thủ trả bóng

Integer – số lượng thư trong chuỗi thư

Ủy quyền

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

• getMessages()

---

getMessages()

Lấy các thư trong chuỗi thư này.

// Log the subjects of the messages in the thread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const messages = firstThread.getMessages();
for (let i = 0; i < messages.length; i++) {
  Logger.log(messages[i].getSubject());
}

Cầu thủ trả bóng

GmailMessage[] – một mảng các thư trên Gmail trong chuỗi thư này

Ủy quyền

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

• getMessageCount()

---

getPermalink()

Lấy một đường liên kết cố định cho chuỗi này.

Xin lưu ý rằng tính năng này chỉ hoạt động với giao diện Gmail truyền thống chứ không hoạt động với Inbox.

// Logs the permalink for the first thread in the inbox
const thread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(thread.getPermalink());

Cầu thủ trả bóng

String – đường liên kết cố định cho chuỗi này

---

hasStarredMessages()

Trả về xem chuỗi có tin nhắn được gắn dấu sao hay không.

// Log if this thread has starred messages
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`has starred : ${firstThread.hasStarredMessages()}`);

Cầu thủ trả bóng

Boolean – true nếu chuỗi tin nhắn có tin nhắn được gắn dấu sao

Ủy quyền

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

• https://mail.google.com/

---

isImportant()

Trả về cho dù chuỗi có được đánh dấu là quan trọng hay không.

// Log if this thread is marked as important
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Important? : ${firstThread.isImportant()}`);

Cầu thủ trả bóng

Boolean – Cho biết chuỗi có được đánh dấu là quan trọng hay không.

Ủy quyền

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

---

isInChats()

Trả về cho dù chuỗi có được gắn nhãn là cuộc trò chuyện hay không.

// Log if this thread is a chat
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`is in chats? : ${firstThread.isInChats()}`);

Cầu thủ trả bóng

Boolean – true nếu chuỗi được gắn nhãn là cuộc trò chuyện

Ủy quyền

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

---

isInInbox()

Trả về việc chuỗi có nằm trong hộp thư đến hay không.

// Log if this thread is in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`is in the inbox? : ${firstThread.isInInbox()}`);

Cầu thủ trả bóng

Boolean – true nếu chuỗi thư nằm trong hộp thư đến

Ủy quyền

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

---

isInPriorityInbox()

Trả về true nếu chuỗi thư này nằm trong hộp thư đến ưu tiên; trả về false trong trường hợp ngược lại.

// Log if this thread is in the priority inbox
const firstThread = GmailApp.getPriorityInboxThreads(0, 1)[0];
Logger.log(`is in priority inbox? ${firstThread.isInPriorityInbox()}`);

Cầu thủ trả bóng

Boolean – true nếu chuỗi thư nằm trong hộp thư ưu tiên

Ủy quyền

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

---

isInSpam()

Trả về xem chuỗi có bị đánh dấu là nội dung rác hay không.

// Log if this thread is in the spam folder
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Spam? ${firstThread.isInSpam()}`);

Cầu thủ trả bóng

Boolean – Chuỗi này có được đánh dấu là nội dung rác hay không.

Ủy quyền

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

---

isInTrash()

Trả về trạng thái của chuỗi hội thoại (có nằm trong thùng rác hay không).

// Log if this thread is in the trash
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Trashed? ${firstThread.isInTrash()}`);

Cầu thủ trả bóng

Boolean – true nếu chuỗi nằm trong thùng rác

Ủy quyền

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

---

isUnread()

Trả về liệu chuỗi có tin nhắn chưa đọc hay không.

// Log if this thread is unread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Unread? ${firstThread.isUnread()}`);

Cầu thủ trả bóng

Boolean – true nếu có tin nhắn chưa đọc

Ủy quyền

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

---

markImportant()

Đánh dấu chuỗi này là quan trọng.

// Mark first inbox thread as important
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markImportant();

Cầu thủ trả bóng

GmailThread – chuỗi này, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• markUnimportant()

---

markRead()

Đánh dấu chuỗi này là đã đọc.

// Mark first inbox thread as read
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markRead();

Cầu thủ trả bóng

GmailThread – chuỗi này, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• markUnread()

---

markUnimportant()

Đánh dấu chuỗi này là không quan trọng.

// Mark first inbox thread as unimportant
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markUnimportant();

Cầu thủ trả bóng

GmailThread – chuỗi này, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• markImportant()

---

markUnread()

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

// Mark first inbox thread as unread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markUnread();

Cầu thủ trả bóng

GmailThread – chuỗi này, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• markRead()

---

moveToArchive()

Chuyển chuỗi này vào kho lưu trữ.

// Archive first inbox thread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.moveToArchive();

Cầu thủ trả bóng

GmailThread – chuỗi này, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

---

moveToInbox()

Chuyển chuỗi này vào hộp thư đến.

// Move first non-inbox thread to inbox
const firstThread = GmailApp.search('-in:inbox')[0];
firstThread.moveToInbox();

Cầu thủ trả bóng

GmailThread – chuỗi này, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

---

moveToSpam()

Chuyển chuỗi tin nhắn này vào thư mục thư rác.

// Move first inbox thread to spam
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.moveToSpam();

Cầu thủ trả bóng

GmailThread – chuỗi này, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

---

moveToTrash()

Chuyển chuỗi tin nhắn này vào thùng rác.

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

Cầu thủ trả bóng

GmailThread – chuỗi này, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

---

refresh()

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

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
// ...Do something that may take a while here....
firstThread.refresh();  // Make sure it's up-to-date
// ...Do more stuff with firstThread ...

Cầu thủ trả bóng

GmailThread – chuỗi này, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

---

removeLabel(label)

Xoá nhãn này khỏi chuỗi thư.

const myLabel = GmailApp.getUserLabelByName('<your label>');
const threads = myLabel.getThreads();
for (const thread of threads) {
  thread.removeLabel(myLabel);
}

Tham số

Tên	Loại	Mô tả
label	GmailLabel	nhãn cần xoá khỏi chuỗi thư này

Cầu thủ trả bóng

GmailThread – chuỗi này, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• addLabel(label)

---

reply(body)

Trả lời người gửi tin nhắn gần đây nhất trong chuỗi này bằng địa chỉ replyTo.

Xin lưu ý rằng tổng kích thước của email (bao gồm cả tất cả tiêu đề) không được vượt quá 20 KB.

// Respond to author of last email in thread with acknowledgment
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.reply('Got your message');

Tham số

Tên	Loại	Mô tả
body	String	nội dung email

Cầu thủ trả bóng

GmailThread – chuỗi này, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• reply(body, options)
• replyAll(body)
• replyAll(body, options)

---

reply(body, options)

Trả lời người gửi thư cuối cùng trong chuỗi thư này bằng địa chỉ replyTo, có thể có các đối số. Email có thể chứa cả văn bản thuần tuý và nội dung HTML. Xin lưu ý rằng tổng kích thước của email (bao gồm tất cả tiêu đề nhưng không bao gồm tệp/tài liệu đính kèm) không được vượt quá 20 KB.

// Respond with HTML body text.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.reply('incapable of HTML', {
  htmlBody: 'some HTML body text',
  noReply: true,
});

Tham số

Tên	Loại	Mô tả
body	String	nội dung email
options	Object	một đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới

Thông số nâng cao

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

Cầu thủ trả bóng

GmailThread – chuỗi này, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• reply(body)
• replyAll(body)
• replyAll(body, options)

---

replyAll(body)

Trả lời người gửi (bằng địa chỉ replyTo) và tất cả người nhận của thư cuối cùng trong chuỗi thư này.

Xin lưu ý rằng tổng kích thước của email (bao gồm cả tất cả tiêu đề) không được vượt quá 20 KB.

// Respond to all with acknowledgment to the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.replyAll('Got your message');

Tham số

Tên	Loại	Mô tả
body	String	nội dung email

Cầu thủ trả bóng

GmailThread – chuỗi này, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• reply(body, options)
• reply(body)
• replyAll(body, options)

---

replyAll(body, options)

Trả lời người gửi (bằng địa chỉ replyTo) và tất cả người nhận của thư cuối cùng trong chuỗi thư này, có thể kèm theo các đối số không bắt buộc. Email có thể chứa cả văn bản thuần tuý và nội dung HTML. Xin lưu ý rằng tổng kích thước của email (bao gồm tất cả tiêu đề nhưng không bao gồm tệp đính kèm) không được vượt quá 20 KB.

// Respond with HTML body text.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.replyAll('incapable of HTML', {
  htmlBody: 'some HTML body text',
  noReply: true,
});

Tham số

Tên	Loại	Mô tả
body	String	nội dung email
options	Object	một đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê bên dưới

Thông số nâng cao

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

Cầu thủ trả bóng

GmailThread – chuỗi này, hữu ích cho việc liên kết

Ủy quyền

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

• https://mail.google.com/

Xem thêm

• reply(body)
• replyAll(body)
• replyAll(body, options)