Class GmailMessage

GmailMessage

Thư trong tài khoản Gmail của người dùng.

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
createDraftReply(body)GmailDraftTạo thư nháp trả lời người gửi thư này bằng địa chỉ trả lời.
createDraftReply(body, options)GmailDraftTạo thư nháp trả lời người gửi thư này bằng địa chỉ trả lời, với đối số không bắt buộc.
createDraftReplyAll(body)GmailDraftTạo thư nháp trả lời người gửi bằng địa chỉ trả lời và tất cả người nhận của thư này.
createDraftReplyAll(body, options)GmailDraftTạo thư nháp trả lời người gửi thư này bằng địa chỉ trả lời và tất cả người nhận, với đối số không bắt buộc.
forward(recipient)GmailMessageChuyển tiếp thư này đến người nhận mới.
forward(recipient, options)GmailMessageChuyển tiếp thư này tới người nhận mới, với đối số không bắt buộc.
getAttachments()GmailAttachment[]Tải tất cả tệp đính kèm cho thư này.
getAttachments(options)GmailAttachment[]Tải tất cả tệp đính kèm cho thư này.
getBcc()StringXem những người nhận được phân tách bằng dấu phẩy được bcc trên thư này.
getBody()StringLấy nội dung HTML trong phần nội dung của thư này.
getCc()StringNhận được những người nhận được phân tách bằng dấu phẩy được cc trên thư này.
getDate()DateXem ngày và giờ của tin nhắn này.
getFrom()StringTìm người gửi tin nhắn này.
getHeader(name)StringLấy giá trị của tiêu đề RFC 2822 đã đặt cho tên tiêu đề.
getId()StringLấy mã nhận dạng của tin nhắn này.
getPlainBody()StringLấy nội dung nội dung của thư này mà không cần định dạng HTML.
getRawContent()StringNhận nội dung thô của thư này.
getReplyTo()StringLấy địa chỉ trả lời của thư này (thường là người gửi).
getSubject()StringLấy tiêu đề của thư này.
getThread()GmailThreadLấy chuỗi có chứa tin nhắn này.
getTo()StringXem những người nhận được phân tách bằng dấu phẩy của thư này.
isDraft()BooleanNhận thông báo xem thư này có phải là thư nháp hay không.
isInChats()BooleanNhận biết liệu tin nhắn này có phải là một cuộc trò chuyện hay không.
isInInbox()BooleanNhận thông báo xem thư này có trong hộp thư đến hay không.
isInPriorityInbox()BooleanTrả về true nếu thư này nằm trong hộp thư đến ưu tiên; nếu không trả về false.
isInTrash()BooleanXem xem thư này có trong thùng rác hay không.
isStarred()BooleanNhận thông báo xem tin nhắn này có được gắn dấu sao hay không.
isUnread()BooleanNhận thông báo xem tin nhắn này có phải là chưa đọc hay không.
markRead()GmailMessageĐánh dấu thư là đã đọc.
markUnread()GmailMessageĐánh dấu thư là chưa đọc.
moveToTrash()GmailMessageChuyển thư vào thùng rác.
refresh()GmailMessageTải lại thư 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).
reply(body)GmailMessageTrả lời người gửi thư này bằng địa chỉ trả lời.
reply(body, options)GmailMessageThư trả lời cho người gửi thư này bằng địa chỉ trả lời, với đối số tùy chọn.
replyAll(body)GmailMessageTrả lời người gửi bằng địa chỉ trả lời và tất cả người nhận thư này.
replyAll(body, options)GmailMessageTrả lời người gửi thư này bằng địa chỉ trả lời và tất cả người nhận, với đối số không bắt buộc.
star()GmailMessageGắn dấu sao cho thư.
unstar()GmailMessageBỏ gắn dấu sao cho thư.

Tài liệu chi tiết

createDraftReply(body)

Tạo thư nháp trả lời người gửi thư này bằng địa chỉ trả lời. Kích thước của email (bao gồm cả tiêu đề) là hạn mức.

// Create a draft reply to the original message with an acknowledgment.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReply("Got your message");

Các tham số

TênLoạiNội dung mô tả
bodyStringNội dung email.

Cầu thủ trả bóng

GmailDraft – Tin nhắn nháp mới được 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


createDraftReply(body, options)

Tạo thư nháp trả lời người gửi thư này bằng địa chỉ trả lời, với đố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 đề) là hạn mức.

// Create a draft response with an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

Các tham số

TênLoạiNội dung mô tả
bodyStringNội dung email.
optionsObjectĐối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây.

Thông số nâng cao

TênLoạiNội dung mô tả
attachmentsBlobSource[]một mảng tệp để gửi cùng với email
bccStringdanh sách địa chỉ email gửi đến BCC được phân tách bằng dấu phẩy
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy
fromStringđịa chỉ dùng để gửi email. Địa chỉ này phải là một trong những giá trị được GmailApp.getAliases() trả về
htmlBodyStringkhi đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng mã 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 bạn có hình ảnh cùng dòng cho email của mình
inlineImagesObjectmột đối tượng JavaScript chứa đường 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 sử dụng và chứa thông tin tham chiếu đến những 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 – Tin nhắn nháp mới được 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


createDraftReplyAll(body)

Tạo thư nháp trả lời người gửi bằ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ả tiêu đề) là hạn mức.

// Create a draft response to all recipients (except those bcc'd) with an acknowledgment.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("Got your message");

Các tham số

TênLoạiNội dung mô tả
bodyStringNội dung email.

Cầu thủ trả bóng

GmailDraft – Tin nhắn nháp mới được 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


createDraftReplyAll(body, options)

Tạo thư nháp trả lời người gửi thư này bằng địa chỉ trả lời và tất cả người nhận, với đố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 đề) là hạn mức.

// Create a draft response to all recipients (except those bcc'd) using an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

Các tham số

TênLoạiNội dung mô tả
bodyStringNội dung email.
optionsObjectĐối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây.

Thông số nâng cao

TênLoạiNội dung mô tả
attachmentsBlobSource[]một mảng tệp để gửi cùng với email
bccStringdanh sách địa chỉ email gửi đến BCC được phân tách bằng dấu phẩy
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy
fromStringđịa chỉ dùng để gửi email. Địa chỉ này phải là một trong những giá trị được GmailApp.getAliases() trả về
htmlBodyStringkhi đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng mã 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 bạn có hình ảnh cùng dòng cho email của mình
inlineImagesObjectmột đối tượng JavaScript chứa đường 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 sử dụng và chứa thông tin tham chiếu đến những 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 – Tin nhắn nháp mới được 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


forward(recipient)

Chuyển tiếp thư này đến người nhận mới. Kích thước của email (bao gồm cả tiêu đề) là hạn mức.

// Forward first message of first inbox thread to recipient1 & recipient2, both @example.com
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.forward("recipient1@example.com,recipient2@example.com");

Các tham số

TênLoạiNội dung mô tả
recipientStringDanh sách địa chỉ email được phân tách bằng dấu phẩy.

Cầu thủ trả bóng

GmailMessage – Thông báo 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 cần được 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 từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


forward(recipient, options)

Chuyển tiếp thư này tới người nhận mới, với đố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 đề) là hạn mức.

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.forward("recipient1@example.com,recipient2@example.com", {
  cc: "myboss@example.com",
  bcc: "mybosses-boss@example.com,vp@example.com"
});

Các tham số

TênLoạiNội dung mô tả
recipientStringDanh sách địa chỉ email được phân tách bằng dấu phẩy.
optionsObjectĐối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây.

Thông số nâng cao

TênLoạiNội dung mô tả
attachmentsBlobSource[]một mảng tệp để gửi cùng với email
bccStringdanh sách địa chỉ email gửi đến BCC được phân tách bằng dấu phẩy
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy
fromStringđịa chỉ dùng để gửi email. Địa chỉ này phải là một trong những giá trị được GmailApp.getAliases() trả về
htmlBodyStringkhi đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng mã 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 bạn có hình ảnh cùng dòng cho email của mình
inlineImagesObjectmột đối tượng JavaScript chứa đường 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 sử dụng và chứa thông tin tham chiếu đến những 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)
noReplyBooleantrue nếu email được gửi từ một địa chỉ email chung không nhận thư trả lời để ngăn người nhận trả lời email. Tuỳ chọn này chỉ áp dụng cho tài khoản Google Workspace, không dùng được cho người dùng Gmail
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

GmailMessage – Thông báo 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 cần được 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 từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


getAttachments()

Tải tất cả tệp đính kèm cho thư này.

Cầu thủ trả bóng

GmailAttachment[] — Một dãy các tệp đính kèm Blob cho 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

getAttachments(options)

Tải tất cả tệp đính kèm cho thư này.

Các tham số

TênLoạiNội dung mô tả
optionsObjectĐối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây.

Thông số nâng cao

TênLoạiNội dung mô tả
includeInlineImagesBooleantrue nếu mảng tệp đính kèm Blob được trả về phải bao gồm hình ảnh cùng dòng (mặc định là true).
includeAttachmentsBooleantrue nếu mảng tệp đính kèm Blob được trả về phải bao gồm các tệp đính kèm thông thường (không cùng dòng) (mặc định là true).

Cầu thủ trả bóng

GmailAttachment[] — Một dãy các tệp đính kèm Blob cho 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

getBcc()

Xem những người nhận được phân tách bằng dấu phẩy được bcc trên thư này.

Mục này trống đối với tất cả thư đã nhận, theo định nghĩa.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getBcc()); // Log bcc'd addresses

Cầu thủ trả bóng

String — Người nhận được phân tách bằng dấu phẩy được bcc trên 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


getBody()

Lấy nội dung HTML trong phần nội dung của thư này.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getBody()); // Log contents of the body

Cầu thủ trả bóng

String — Nội dung của 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


getCc()

Nhận được những người nhận được phân tách bằng dấu phẩy được cc trên thư này.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getCc()); // Log cc'd addresses

Cầu thủ trả bóng

String — Người nhận được phân tách bằng dấu phẩy đã cc cho 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


getDate()

Xem ngày và giờ của tin nhắn này.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getDate()); // Log date and time of the message

Cầu thủ trả bóng

Date – Ngày và giờ của tin nhắn 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

getFrom()

Tìm người gửi tin nhắn này.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getFrom()); // Log from address of the message

Cầu thủ trả bóng

String — Địa chỉ email của người gử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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


getHeader(name)

Lấy giá trị của tiêu đề RFC 2822 đã đặt cho tên tiêu đề.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox.
var message = thread.getMessages()[0];         // Get the first message.
Logger.log(message.getHeader("Message-ID"));   // Logs the Message-ID RFC 2822 header.

Các tham số

TênLoạiNội dung mô tả
nameStringTên của tiêu đề RFC, không có dấu hai chấm phân tách với giá trị.

Cầu thủ trả bóng

String – Giá trị của tiêu đề hoặc một chuỗi trống nếu tiêu đề không tồn tại trong 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

getId()

Lấy mã nhận dạng của tin nhắn này.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
var id = message.getId();
var messageById = GmailApp.getMessageById(id);
Logger.log(message.getSubject() == messageById.getMessage()); // Always logs true

Cầu thủ trả bóng

String – Mã nhận dạng của thư.


getPlainBody()

Lấy nội dung nội dung của thư này mà không cần định dạng HTML. Việc này phức tạp hơn so với getBody() và mất nhiều thời gian hơn.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getPlainBody()); // Log contents of the body

Cầu thủ trả bóng

String — Nội dung đơn giản của 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


getRawContent()

Nhận nội dung thô của thư này. Điều này tương đương với việc "Hiển thị thư gốc" trong giao diện người dùng Gmail.

Cầu thủ trả bóng

String – Nội dung thô của 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

getReplyTo()

Lấy địa chỉ trả lời của thư này (thường là người gửi).

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getReplyTo()); // Logs reply-to address

Cầu thủ trả bóng

String – Địa chỉ email để trả lờ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


getSubject()

Lấy tiêu đề của thư này.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getSubject()); // Log subject line

Cầu thủ trả bóng

String — Chủ đề của 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


getThread()

Lấy chuỗi có chứa tin nhắn này.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getThread().getFirstMessageSubject() ==
           thread.getFirstMessageSubject()); // Always logs true

Cầu thủ trả bóng

GmailThread — GmailThread chứa 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

getTo()

Xem những người nhận được phân tách bằng dấu phẩy của thư này.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getTo()); // Log the recipient of message

Cầu thủ trả bóng

String — Người nhận thư này được phân tách bằng dấu phẩ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


isDraft()

Nhận thông báo xem thư này có phải là thư nháp hay không.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is draft? " + message.isDraft());

Cầu thủ trả bóng

Boolean — Liệu thư này có phải là thư nháp 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

isInChats()

Nhận biết liệu tin nhắn này có phải là một cuộc trò chuyện hay không.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is a chat? " + message.isInChats());

Cầu thủ trả bóng

Boolean — Liệu tin nhắn này có phải là một cuộc trò chuyện hay không.


isInInbox()

Nhận thông báo xem thư này có trong hộp thư đến hay không.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in inbox? " + message.isInInbox());

Cầu thủ trả bóng

Boolean — Liệu thư này có trong hộp thư đến 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

isInPriorityInbox()

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

var thread = GmailApp.getPriorityInboxThreads(0,1)[0]; // Get first thread in priority inbox
var messages = thread.getMessages();
for (var i = 0; i < messages.length; i++) {
  // At least one of the messages is in priority inbox
  Logger.log("is in priority inbox? " + messages[i].isInPriorityInbox());
}

Cầu thủ trả bóng

Boolean — Liệu thư này có nằm trong hộp thư đến ưu tiên 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

isInTrash()

Xem xem thư này có trong thùng rác hay không.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in the trash? " + message.isInTrash());

Cầu thủ trả bóng

Boolean — Liệu thư này có trong thùng rác hay không.


isStarred()

Nhận thông báo xem tin nhắn này có được gắn dấu sao hay không.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is starred? " + message.isStarred());

Cầu thủ trả bóng

Boolean — Liệu tin nhắn này có được gắn dấu sao hay không.


isUnread()

Nhận thông báo xem tin nhắn này có phải là chưa đọc hay không.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is unread? " + message.isUnread());

Cầu thủ trả bóng

Boolean — Trạng thái chưa đọc của tin nhắn 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

markRead()

Đánh dấu thư là đã đọc.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.markRead(); // Mark as read

Cầu thủ trả bóng

GmailMessage – Thư trong Gmail 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 cần được 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 từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


markUnread()

Đánh dấu thư là chưa đọc.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.markUnread(); // Mark as unread

Cầu thủ trả bóng

GmailMessage – Thư trong Gmail 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 cần được 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 từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


moveToTrash()

Chuyển thư vào thùng rác.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.moveToTrash(); // Move message to trash

Cầu thủ trả bóng

GmailMessage – Thư trong Gmail 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 cần được 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 từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


refresh()

Tải lại thư 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).

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
// .. Do bunch of stuff here
message.refresh(); // Make sure it's up to date
// Do more stuff to message

Cầu thủ trả bóng

GmailMessage – Thông báo này để tạo 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

reply(body)

Trả lời người gửi thư này bằng địa chỉ trả lời. Kích thước của email (bao gồm cả tiêu đề) là hạn mức.

// Respond to author of message with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.reply("Got your message");

Các tham số

TênLoạiNội dung mô tả
bodyStringNội dung email.

Cầu thủ trả bóng

GmailMessage – Thông báo 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 cần được 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 từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


reply(body, options)

Thư trả lời cho người gửi thư này bằng địa chỉ trả lời, với đối số tùy chọn.

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 đề) là hạn mức.

// Respond with HTML body text
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.reply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  noReply: true
});

Các tham số

TênLoạiNội dung mô tả
bodyStringNội dung email.
optionsObjectĐối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây.

Thông số nâng cao

TênLoạiNội dung mô tả
attachmentsBlobSource[]một mảng tệp để gửi cùng với email
bccStringdanh sách địa chỉ email gửi đến BCC được phân tách bằng dấu phẩy
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy
fromStringđịa chỉ dùng để gửi email. Địa chỉ này phải là một trong những giá trị được GmailApp.getAliases() trả về
htmlBodyStringkhi đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng mã 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 bạn có hình ảnh cùng dòng cho email của mình
inlineImagesObjectmột đối tượng JavaScript chứa đường 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 sử dụng và chứa thông tin tham chiếu đến những 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)
noReplyBooleantrue nếu email được gửi từ một địa chỉ email chung không nhận thư trả lời để ngăn người nhận trả lời email. Tuỳ chọn này chỉ áp dụng cho tài khoản Google Workspace, không dùng được cho người dùng Gmail
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

GmailMessage – Thông báo 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 cần được 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 từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


replyAll(body)

Trả lời người gửi bằ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 đề) là hạn mức.

// Respond to all recipients (except bcc'd) of last email in thread with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.replyAll("Got your message");

Các tham số

TênLoạiNội dung mô tả
bodyStringNội dung email.

Cầu thủ trả bóng

GmailMessage – Thông báo này,hữu ích khi tạo 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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


replyAll(body, options)

Trả lời người gửi thư này bằng địa chỉ trả lời và tất cả người nhận, với đố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 đề) là hạn mức.

// Respond with HTML body text
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
messageThread.replyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  noReply: true
});

Các tham số

TênLoạiNội dung mô tả
bodyStringNội dung email.
optionsObjectĐối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây.

Thông số nâng cao

TênLoạiNội dung mô tả
attachmentsBlobSource[]một mảng tệp để gửi cùng với email
bccStringdanh sách địa chỉ email gửi đến BCC được phân tách bằng dấu phẩy
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy
fromStringđịa chỉ dùng để gửi email. Địa chỉ này phải là một trong những giá trị được GmailApp.getAliases() trả về
htmlBodyStringkhi đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng mã 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 bạn có hình ảnh cùng dòng cho email của mình
inlineImagesObjectmột đối tượng JavaScript chứa đường 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 sử dụng và chứa thông tin tham chiếu đến những 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)
noReplyBooleantrue nếu email được gửi từ một địa chỉ email chung không nhận thư trả lời để ngăn người nhận trả lời email. Tuỳ chọn này chỉ áp dụng cho tài khoản Google Workspace, không dùng được cho người dùng Gmail
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

GmailMessage – Thông báo 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 cần được 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 từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


star()

Gắn dấu sao cho thư.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.star(); // Star the message

Cầu thủ trả bóng

GmailMessage – Thư trong Gmail 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 cần được 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 từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm


unstar()

Bỏ gắn dấu sao cho thư.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.unstar(); // Unstar the message

Cầu thủ trả bóng

GmailMessage – Thư trong Gmail 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 cần được 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 từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm