Class GmailMessage

GmailTin nhắn

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 địa chỉ trả lời, với các đố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 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 các đố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 đến người nhận mới, với các đối số không bắt buộc.
getAttachments()GmailAttachment[]Lấy tất cả tệp đính kèm cho thư này.
getAttachments(options)GmailAttachment[]Lấy tất cả tệp đính kèm cho thư này.
getBcc()StringLấy những người nhận được bcc đượ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 phần nội dung thư này.
getCc()StringLấy những người nhận được cc được phân tách bằng dấu phẩy trên thư này.
getDate()DateLấy ngày và giờ của thông báo này.
getFrom()StringLấy người gửi thư này.
getHeader(name)StringLấy giá trị của tiêu đề RFC 2822 theo 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 phần nội dung thư này mà không định dạng HTML.
getRawContent()StringLấy 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 chứa thông báo này.
getTo()StringLấy người nhận được phân tách bằng dấu phẩy của thư này.
isDraft()BooleanXác định xem thư này có phải là thư nháp hay không.
isInChats()BooleanXem liệu tin nhắn này có phải là tin nhắn trò chuyện hay không.
isInInbox()BooleanXem 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; trả về false nếu không.
isInTrash()BooleanXem thư này có nằm 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()BooleanXem 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 quan từ Gmail (rất 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 địa chỉ trả lời, với các đối số không bắt buộc.
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 các đối số không bắt buộc.
star()GmailMessageGắn dấu sao cho thư.
unstar()GmailMessageBỏ gắn dấu sao cho tin nhắn.

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 đề) bị giới hạn hạn mức.

// Create a draft reply to the original message with an acknowledgment.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.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 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 thư nháp trả lời người gử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];
const 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 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ề
htmlBodyStringkhi được đặt, các thiết bị có thể hiển thị HTML sẽ sử dụng thuộc tính này thay vì đối số body 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 đã nhúng hình ảnh vào 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 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 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 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 response to all recipients (except those bcc'd) with an
// acknowledgment.
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 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 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 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 to all recipients (except those bcc'd) using an HTML
// text body.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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 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ề
htmlBodyStringkhi được đặt, các thiết bị có thể hiển thị HTML sẽ sử dụng thuộc tính này thay vì đối số body 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 đã nhúng hình ảnh vào 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 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


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 đề) bị giới hạn theo hạn mức.

// Forward first message of first inbox thread to recipient1 & recipient2,
// both @example.com
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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

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


forward(recipient, options)

Chuyển tiếp thư này đến 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 cả tiêu đề) bị giới hạn theo hạn mức.

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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.
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ề
htmlBodyStringkhi được đặt, các thiết bị có thể hiển thị HTML sẽ sử dụng thuộc tính này thay vì đối số body 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 đã nhúng hình ảnh vào 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)
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
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 yêu cầu 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


getAttachments()

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

Cầu thủ trả bóng

GmailAttachment[] – Một mảng 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 yêu cầu 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/

getAttachments(options)

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

Tham số

TênLoạiMô tả
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ả
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 mảng 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 yêu cầu 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/

getBcc()

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

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

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

Cầu thủ trả bóng

String – Những người nhận được thêm vào phần bcc của 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 yêu cầu 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


getBody()

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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 yêu cầu 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


getCc()

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

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

Cầu thủ trả bóng

String – Những người nhận được cc trong 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 yêu cầu 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


getDate()

Lấy ngày và giờ của thông báo này.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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 thông báo này.

Ủy quyền

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

getFrom()

Lấy người gửi thư này.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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 yêu cầu 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


getHeader(name)

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox.
const 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 tách tên 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ông báo.

Ủy quyền

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

getId()

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
const id = message.getId();
const 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 thư.


getPlainBody()

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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 phần nội dung thuần tuý của 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 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


getRawContent()

Lấy nội dung thô của thư này. Thao tác này tương đương với thao tác "Hiển thị thư gốc" trong giao diện người dùng của 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 yêu cầu 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/

getReplyTo()

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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 yêu cầu 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


getSubject()

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

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

Cầu thủ trả bóng

String – Tiêu đề của 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 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


getThread()

Lấy chuỗi chứa thông báo này.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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 yêu cầu 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/

getTo()

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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 được phân tách bằng dấu phẩy của 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 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


isDraft()

Xác định xem thư này có phải là thư nháp hay không.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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 yêu cầu 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()

Xem liệu tin nhắn này có phải là tin nhắn trò chuyện hay không.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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à tin nhắn trò chuyện hay không.


isInInbox()

Xem thư này có trong hộp thư đến hay không.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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

Các tập lệnh sử dụng phương thức này yêu cầu 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 thư này nằm trong hộp thư ưu tiên; trả về false nếu không.

const thread = GmailApp.getPriorityInboxThreads(
    0, 1)[0];  // Get first thread in priority inbox
const messages = thread.getMessages();
for (let 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

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

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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()

Xem tin nhắn này có phải là chưa đọc hay không.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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 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 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/

markRead()

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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

Các tập lệnh sử dụng phương thức này yêu cầu 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 thư là chưa đọc.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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

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


moveToTrash()

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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

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


refresh()

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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 yêu cầu 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/

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 đề) bị giới hạn theo hạn mức.

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

Tham số

TênLoạiMô tả
bodyStringNội dung của 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 yêu cầu 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ư 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.

// Respond with HTML body text
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const 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 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ề
htmlBodyStringkhi được đặt, các thiết bị có thể hiển thị HTML sẽ sử dụng thuộc tính này thay vì đối số body 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 đã nhúng hình ảnh vào 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)
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
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 yêu cầu 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 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 đề) bị giới hạn theo hạn mức.

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

Tham số

TênLoạiMô tả
bodyStringNội dung của 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 yêu cầu 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 thư này bằ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.

// Respond with HTML body text
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const message = firstThread.getMessages()[0];
message.replyAll('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  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ả
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ề
htmlBodyStringkhi được đặt, các thiết bị có thể hiển thị HTML sẽ sử dụng thuộc tính này thay vì đối số body 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 đã nhúng hình ảnh vào 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)
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
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 yêu cầu 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


star()

Gắn dấu sao cho thư.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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

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


unstar()

Bỏ gắn dấu sao cho tin nhắn.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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

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