Class GmailMessage

GmailMessage

Một 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
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 cách sử dụ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 cho người gửi bằng cách sử dụng địa chỉ trả lời và tất cả người nhận của tin nhắn này.
createDraftReplyAll(body, options)GmailDraftTạo thư nháp để trả lời người gửi thư này bằng cách sử dụng địa chỉ trả lời và tất cả người nhận, với các đối số tuỳ chọn.
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 các đố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 bcc của những người nhận được phân tách bằng dấu phẩy trên thư này.
getBody()StringLấy nội dung HTML của nội dung thư này.
getCc()StringXem 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 thư này.
getHeader(name)StringLấy giá trị của tiêu đề RFC 2822 cho trước tên tiêu đề.
getId()StringLấy mã nhận dạng của thư này.
getPlainBody()StringLấy nội dung của thư này ở định dạng HTML.
getRawContent()StringLấy nội dung thô của thư này.
getReplyTo()StringNhận địa chỉ trả lời của thư này (thường là người gửi).
getSubject()StringXem tiêu đề của thư này.
getThread()GmailThreadXem chuỗi chứa thư này.
getTo()StringXem những người nhận thư này được phân tách bằng dấu phẩy.
isDraft()BooleanXem tin nhắn này có phải là tin nhắn nháp hay không.
isInChats()BooleanXem tin nhắn này có phải là tin nhắn trò chuyện hay không.
isInInbox()BooleanBiết được 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ư ưu tiên; nếu không thì sẽ trả về false.
isInTrash()BooleanXem thư này có trong thùng rác hay không.
isStarred()BooleanXem tin nhắn này có được gắn dấu sao hay không.
isUnread()BooleanBiết được 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)GmailMessageTrả lời người gửi thư này bằng cách sử dụng địa chỉ trả lời, với các đối số không bắt buộc.
replyAll(body)GmailMessageTrả lời cho 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 cách sử dụ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 tin nhắn.
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. Chiến lược phát hành đĩa đơn kích thước của email (bao gồm cả phần đầu thư) bị giới hạn 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");

Tham số

TênLoạiMô 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

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


createDraftReply(body, options)

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

// 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"
});

Tham số

TênLoạiMô tả
bodyStringNội dung email.
optionsObjectĐố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 mảng tệp để gửi cùng với email
bccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy tới BCC
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để gửi CC
fromStringđịa chỉ email phải được gửi từ đó trong các giá trị được GmailApp.getAliases() trả về
htmlBodyStringkhi được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng HTML 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 phần nội dung HTML nếu bạn có hình ảnh cùng dòng cho email
inlineImagesObjectđố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" />
nameStringtên người gửi email (mặc định: tên của người dùng)
replyToStringđị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)
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

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


createDraftReplyAll(body)

Tạo thư nháp trả lời cho người gửi bằng cách sử dụng địa chỉ trả lời và tất cả người nhận của tin nhắn này. 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.

// 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");

Tham số

TênLoạiMô 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

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


createDraftReplyAll(body, options)

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

// 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"
});

Tham số

TênLoạiMô tả
bodyStringNội dung email.
optionsObjectĐố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 mảng tệp để gửi cùng với email
bccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy tới BCC
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để gửi CC
fromStringđịa chỉ email phải được gửi từ đó trong các giá trị được GmailApp.getAliases() trả về
htmlBodyStringkhi được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng HTML 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 phần nội dung HTML nếu bạn có hình ảnh cùng dòng cho email
inlineImagesObjectđố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" />
nameStringtên người gửi email (mặc định: tên của người dùng)
replyToStringđị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)
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

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


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ả phần thông tin thư) bị giới hạn 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");

Tham số

TênLoạiMô 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

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


forward(recipient, options)

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

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"
});

Tham số

TênLoạiMô 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ê bên dưới.

Thông số nâng cao

TênLoạiMô tả
attachmentsBlobSource[]một mảng tệp để gửi cùng với email
bccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy tới BCC
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để gửi CC
fromStringđịa chỉ email phải được gửi từ đó trong các giá trị được GmailApp.getAliases() trả về
htmlBodyStringkhi được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng HTML 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 phần nội dung HTML nếu bạn có hình ảnh cùng dòng cho email
inlineImagesObjectđố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" />
nameStringtên người gửi email (mặc định: tên của người dùng)
noReplyBooleantrue 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
replyToStringđị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)
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

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


getAttachments()

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

Cầu thủ trả bóng

GmailAttachment[] — Một loạt tệp đính kèm Blob cho thư 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/

getAttachments(options)

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

Tham số

TênLoạiMô tả
optionsObjectĐố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ả
includeInlineImagesBooleantrue nếu mảng Blob được trả về tệp đính kèm phải bao gồm hình ảnh cùng dòng (mặc định là true).
includeAttachmentsBooleantrue nếu mảng Blob được trả về tệp đính kèm 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 loạt tệp đính kèm Blob cho thư 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/

getBcc()

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

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

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 đã đăng ký bcc trên thư 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


getBody()

Lấy nội dung HTML của nội dung 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 nội dung của thư 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


getCc()

Xem 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 đã được cc trên thư 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


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

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/

getFrom()

Tìm người gửi 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.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

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


getHeader(name)

Lấy giá trị của tiêu đề RFC 2822 cho trước 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.

Tham số

TênLoạiMô tả
nameStringTên của tiêu đề RFC không có dấu hai chấm phân cá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 không có tiêu đề trong thông bá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/

getId()

Lấy mã nhận dạng 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
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 của thư này ở định dạng HTML. Cách này phức tạp hơn 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 thuần tuý của thông báo 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


getRawContent()

Lấy nội dung thô của thư này. Điều này tương đương với "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

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/

getReplyTo()

Nhận đị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

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


getSubject()

Xem 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

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


getThread()

Xem chuỗi chứ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.getThread().getFirstMessageSubject() ==
           thread.getFirstMessageSubject()); // Always logs true

Cầu thủ trả bóng

GmailThread — Chuỗi Gmail chứa thư 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/

getTo()

Xem những người nhận thư này được phân tách bằng dấu phẩ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 — Những người nhận thư này được phân tách bằng dấu phẩ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


isDraft()

Xem tin nhắn này có phải là tin nhắn 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 — Thư này có phải là thư nháp hay không.

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

isInChats()

Xem tin nhắn này có phải là tin nhắn 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 — Tin nhắn này có phải là tin nhắn trò chuyện hay không.


isInInbox()

Biết được 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ó nằm trong hộp thư đến hay không.

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

isInPriorityInbox()

Trả về true nếu thư này nằm trong hộp thư ưu tiên; nếu không thì sẽ 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ư ưu tiên hay không.

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

isInTrash()

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ó nằm trong thùng rác hay không.


isStarred()

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 — Thư này có được gắn dấu sao hay không.


isUnread()

Biết được 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

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/

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 – GmailMessage này, 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


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 – GmailMessage này, 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


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 – GmailMessage này, 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


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

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/

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 tiêu đề) là hạn mức bị hạn chế.

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

Tham số

TênLoạiMô 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

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


reply(body, options)

Trả lời người gửi thư này bằng cách sử dụ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 tiêu đề) là hạn mức bị hạn chế.

// 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
});

Tham số

TênLoạiMô tả
bodyStringNội dung email.
optionsObjectĐố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 mảng tệp để gửi cùng với email
bccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy tới BCC
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để gửi CC
fromStringđịa chỉ email phải được gửi từ đó trong các giá trị được GmailApp.getAliases() trả về
htmlBodyStringkhi được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng HTML 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 phần nội dung HTML nếu bạn có hình ảnh cùng dòng cho email
inlineImagesObjectđố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" />
nameStringtên người gửi email (mặc định: tên của người dùng)
noReplyBooleantrue 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
replyToStringđị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)
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

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


replyAll(body)

Trả lời cho 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ả phần đầu) bị giới hạn 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");

Tham số

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

Cầu thủ trả bóng

GmailMessage – Thông báo này rất 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


replyAll(body, options)

Trả lời người gửi thư này bằng cách sử dụ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 tiêu đề) là hạn mức bị hạn chế.

// 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
});

Tham số

TênLoạiMô tả
bodyStringNội dung email.
optionsObjectĐố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 mảng tệp để gửi cùng với email
bccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy tới BCC
ccStringdanh sách địa chỉ email được phân tách bằng dấu phẩy để gửi CC
fromStringđịa chỉ email phải được gửi từ đó trong các giá trị được GmailApp.getAliases() trả về
htmlBodyStringkhi được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng HTML 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 phần nội dung HTML nếu bạn có hình ảnh cùng dòng cho email
inlineImagesObjectđố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" />
nameStringtên người gửi email (mặc định: tên của người dùng)
noReplyBooleantrue 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
replyToStringđị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)
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

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


star()

Gắn dấu sao cho tin nhắn.

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 – GmailMessage này, 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


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 – GmailMessage này, 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