Class GmailThread

GmailLuồng thư

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

Phương thức

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

// 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ênLoạiMô tả
labelGmailLabelnhãn cần áp dụng cho chuỗi thư này

Cầu thủ trả bóng

GmailThread – luồng này, 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 đượ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

createDraftReply(body)

Tạo một thư nháp trả lời người gửi thư cuối cùng trong chuỗi thư này bằng địa chỉ trả lời. Kích thước của email (bao gồm cả tiêu đề) bị giới hạn theo 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ênLoạiMô tả
bodyStringnội dung của 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 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/

Xem thêm

createDraftReply(body, options)

Tạo một thư nháp trả lời người gửi thư cuối cùng trong chuỗi thư này bằng địa chỉ trả lời, với 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 đề) bị giới hạn theo 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: 'another@example.com',
});

Tham số

TênLoạiMô tả
bodyStringnội dung của email
optionsObjectmộ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ênLoạiMô tả
attachmentsBlobSource[]một آرایه tệp để gửi cùng email
bccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để gửi bcc
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để thêm vào phần Cc
fromStringđịa chỉ gửi email, phải là một trong các giá trị mà GmailApp.getAliases() trả về
htmlBodyStringnếu được đặt, các thiết bị có thể hiển thị HTML sẽ sử dụng trường 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
inlineImagesObjectmộ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" />
nameStringtên của người gửi email (mặc định: tên của người dùng)
replyToStringđị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)
subjectStringdò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 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/

Xem thêm

createDraftReplyAll(body)

Tạo một thư nháp trả lời người gửi thư gần nhất trong chuỗi thư này, sử dụng địa chỉ trả lời và tất cả người nhận thư này. Kích thước của email (bao gồm cả tiêu đề) bị giới hạn theo 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ênLoạiMô tả
bodyStringnội dung của 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 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/

Xem thêm

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 thư này, sử dụng địa chỉ trả lời và tất cả người nhận, với 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 đề) bị giới hạn theo 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: 'another@example.com',
});

Tham số

TênLoạiMô tả
bodyStringnội dung của email
optionsObjectmộ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ênLoạiMô tả
attachmentsBlobSource[]một آرایه tệp để gửi cùng email
bccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để gửi bcc
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để thêm vào phần Cc
fromStringđịa chỉ gửi email, phải là một trong các giá trị mà GmailApp.getAliases() trả về
htmlBodyStringnếu được đặt, các thiết bị có thể hiển thị HTML sẽ sử dụng trường 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
inlineImagesObjectmộ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" />
nameStringtên của người gửi email (mặc định: tên của người dùng)
replyToStringđị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)
subjectStringdò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 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/

Xem thêm

getFirstMessageSubject()

Lấy tiêu đề của thư đầu tiên trong chuỗi thư. 

// 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 thư đầu tiên trong chuỗi thư

Ủ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/

Xem thêm

getId()

Lấy mã của luồng này. Mã của một chuỗi tin nhắn thay đổi tuỳ theo các tin nhắn mà chuỗi tin nhắn đó chứa; để có một mã nhất quán cho một tin nhắn cụ thể trong chuỗi tin nhắn, 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 tin nhắn này

getLabels()

Trả về các nhãn do người dùng tạo trên chuỗi tin nhắn 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 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 đượ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 thư gần đây nhất trong chuỗi thư 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 tin nhắn

Ủ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/

Xem thêm

getMessageCount()

Trả về số lượng tin nhắn trong chuỗi tin nhắ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 tin nhắn trong chuỗi tin nhắn

Ủ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/

Xem thêm

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 gồm các thư 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 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/

Xem thêm

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

Xin lưu ý rằng tính năng này chỉ hoạt động với giao diện Gmail cổ điển, chứ không phả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 của chuỗi tin nhắn này

hasStarredMessages()

Trả về thông tin về việc chuỗi tin nhắn có tin nhắn nào đượ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 – đúng nếu chuỗi tin nhắn có tin nhắn nào được gắn dấu sao

Ủ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/

isImportant()

Trả về thông tin về việc chuỗi tin nhắn 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 – Liệu chuỗi tin nhắn 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 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/

isInChats()

Trả về thông tin về việc chuỗi tin nhắn 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 – đúng 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 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/

isInInbox()

Trả về thông tin về việc chuỗi thư 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 – đúng 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 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/

isInPriorityInbox()

Trả về true nếu chuỗi thư này nằm trong hộp thư ưu tiên; trả về false nếu không. 

// 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 – đúng 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 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/

isInSpam()

Trả về thông tin về việc chuỗi tin nhắn 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 – Liệu chuỗi tin nhắn này có bị đá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 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/

isInTrash()

Trả về thông tin về việc chuỗi tin nhắn 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 – đúng nếu chuỗi tin nhắn 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 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/

isUnread()

Trả về thông tin về việc chuỗi tin nhắn có thư 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 – đúng 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 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/

markImportant()

Đánh dấu chuỗi thư 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 – luồng này, 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 đượ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()

Đánh dấu chuỗi tin nhắn 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 – luồng này, 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 đượ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()

Đánh dấu chuỗi tin nhắn 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 – luồng này, 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 đượ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()

Đánh dấu chuỗi thư 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 – luồng này, 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 đượ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

moveToArchive()

Di chuyển chuỗi tin nhắn này vào mục lưu trữ. 

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

Cầu thủ trả bóng

GmailThread – luồng này, 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 đượ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 thư 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 – luồng này, 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 đượ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 – luồng này, 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 đượ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 thư 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 – luồng này, 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 đượ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 thư này 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 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 – luồng này, 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 đượ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 tin nhắn. 

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

Tham số

TênLoạiMô tả
labelGmailLabelnhãn cần xoá khỏi chuỗi thư này

Cầu thủ trả bóng

GmailThread – luồng này, 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 đượ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)

Trả lời người gửi thư cuối cùng trong chuỗi thư 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ênLoạiMô tả
bodyStringnội dung của email

Cầu thủ trả bóng

GmailThread – luồng này, 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 đượ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)

Trả lời người gửi thư cuối cùng trên chuỗi thư này bằng địa chỉ replyTo, với 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.reply('incapable of HTML', {
  htmlBody: 'some HTML body text',
  noReply: true,
});

Tham số

TênLoạiMô tả
bodyStringnội dung của email
optionsObjectmộ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ênLoạiMô tả
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để thêm vào phần Cc
bccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để gửi bcc
htmlBodyStringnếu được đặt, các thiết bị có thể hiển thị HTML sẽ sử dụng trường 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
nameStringtên của người gửi email (mặc định: tên của người dùng)
fromStringđịa chỉ gửi email, phải là một trong các giá trị mà GmailApp.getAliases() trả về
replyToStringđị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)
noReplyBooleantrue 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
attachmentsBlobSource[]một آرایه tệp để gửi cùng email
inlineImagesObjectmộ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" />

Cầu thủ trả bóng

GmailThread – luồng này, 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 đượ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)

Trả lời người gửi (sử dụng địa chỉ replyTo) và tất cả người nhận thư cuối cùng trên 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ênLoạiMô tả
bodyStringnội dung của email

Cầu thủ trả bóng

GmailThread – luồng này, 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 đượ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)

Trả lời người gửi (sử dụng địa chỉ replyTo) và tất cả người nhận thư gần đây nhất trên chuỗi thư này, với 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ênLoạiMô tả
bodyStringnội dung của email
optionsObjectmộ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ênLoạiMô tả
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để thêm vào phần Cc
bccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để gửi bcc
htmlBodyStringnếu được đặt, các thiết bị có thể hiển thị HTML sẽ sử dụng trường 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
nameStringtên của người gửi email (mặc định: tên của người dùng)
fromStringđịa chỉ gửi email, phải là một trong các giá trị mà GmailApp.getAliases() trả về
replyToStringđị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)
noReplyBooleantrue 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 G Suite, chứ không phải người dùng Gmail
attachmentsBlobSource[]một آرایه tệp để gửi cùng email
inlineImagesObjectmộ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" />

Cầu thủ trả bóng

GmailThread – luồng này, 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 đượ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