Class GmailApp

GmailApp

Cấp quyền truy cập vào các chuỗi thư, thư và nhãn trong Gmail.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
createDraft(recipient, subject, body)GmailDraftTạo email nháp.
createDraft(recipient, subject, body, options)GmailDraftTạo email nháp có các đối số không bắt buộc.
createLabel(name)GmailLabelTạo một nhãn người dùng mới cho tên được cung cấp.
deleteLabel(label)GmailAppXoá nhãn đã chỉ định.
getAliases()String[]Lấy danh sách email được thiết lập làm email đại diện cho tài khoản này trong Gmail.
getDraft(draftId)GmailDraftTruy xuất thư nháp theo mã nhận dạng.
getDraftMessages()GmailMessage[]Truy xuất tất cả thư nháp.
getDrafts()GmailDraft[]Nhận tất cả thư nháp trong Gmail.
getInboxThreads()GmailThread[]Truy xuất tất cả các chuỗi trong Hộp thư đến, bất kể nhãn là gì.
getInboxThreads(start, max)GmailThread[]Truy xuất một loạt chuỗi trong Hộp thư đến, bất kể nhãn là gì.
getInboxUnreadCount()IntegerLấy số chuỗi tin nhắn chưa đọc trong hộp thư đến.
getMessageById(id)GmailMessageNhận tin nhắn theo mã nhận dạng.
getMessagesForThread(thread)GmailMessage[]Truy xuất tất cả thư trong chuỗi được chỉ định.
getMessagesForThreads(threads)GmailMessage[][]Truy xuất tất cả tin nhắn trong chuỗi được chỉ định.
getPriorityInboxThreads()GmailThread[]Truy xuất tất cả các chuỗi trong Hộp thư ưu tiên, bất kể nhãn.
getPriorityInboxThreads(start, max)GmailThread[]Truy xuất một loạt các chuỗi trong Hộp thư ưu tiên, bất kể nhãn.
getPriorityInboxUnreadCount()IntegerLấy số chuỗi tin nhắn chưa đọc trong Hộp thư ưu tiên.
getSpamThreads()GmailThread[]Truy xuất tất cả các chuỗi thư rác, bất kể nhãn.
getSpamThreads(start, max)GmailThread[]Truy xuất một loạt chuỗi thư rác, bất kể nhãn là gì.
getSpamUnreadCount()IntegerLấy số lượng chuỗi tin nhắn rác chưa đọc.
getStarredThreads()GmailThread[]Truy xuất tất cả các chuỗi có gắn dấu sao, bất kể nhãn.
getStarredThreads(start, max)GmailThread[]Truy xuất một loạt chuỗi thư có gắn dấu sao, bất kể nhãn.
getStarredUnreadCount()IntegerXem số lượng chuỗi tin nhắn chưa đọc được gắn dấu sao.
getThreadById(id)GmailThreadNhận một chuỗi theo mã nhận dạng.
getTrashThreads()GmailThread[]Truy xuất tất cả các chuỗi trong thùng rác, bất kể nhãn là gì.
getTrashThreads(start, max)GmailThread[]Truy xuất một loạt các chuỗi thùng rác, bất kể nhãn là gì.
getUserLabelByName(name)GmailLabelTruy xuất nhãn đã cho tên nhãn.
getUserLabels()GmailLabel[]Truy xuất danh sách nhãn do người dùng tạo.
markMessageRead(message)GmailAppĐánh dấu thông báo này là đã đọc và buộc thư làm mới.
markMessageUnread(message)GmailAppĐánh dấu thông báo này là chưa đọc và buộc thư làm mới.
markMessagesRead(messages)GmailAppĐánh dấu những thư này là đã đọc và buộc các thư làm mới.
markMessagesUnread(messages)GmailAppĐánh dấu những thư này là chưa đọc và buộc các thư làm mới.
markThreadImportant(thread)GmailAppĐánh dấu luồng này là quan trọng và buộc luồng làm mới.
markThreadRead(thread)GmailAppĐánh dấu chuỗi này là đã đọc và buộc chuỗi làm mới.
markThreadUnimportant(thread)GmailAppĐánh dấu luồng này là không quan trọng và buộc luồng làm mới.
markThreadUnread(thread)GmailAppĐánh dấu chuỗi này là chưa đọc và buộc chuỗi làm mới.
markThreadsImportant(threads)GmailAppĐánh dấu những luồng này là quan trọng và buộc các luồng này làm mới.
markThreadsRead(threads)GmailAppĐánh dấu những luồng này là đã đọc và buộc các luồng làm mới.
markThreadsUnimportant(threads)GmailAppĐánh dấu những luồng này là không quan trọng và buộc các luồng này làm mới.
markThreadsUnread(threads)GmailAppĐánh dấu các chuỗi này là chưa đọc và buộc các chuỗi này làm mới.
moveMessageToTrash(message)GmailAppChuyển thư vào thùng rác và buộc làm mới thư.
moveMessagesToTrash(messages)GmailAppChuyển các thư được chỉ định vào thùng rác và buộc thư làm mới.
moveThreadToArchive(thread)GmailAppDi chuyển luồng này đến mục lưu trữ và buộc luồng làm mới.
moveThreadToInbox(thread)GmailAppDi chuyển chuỗi thư này vào hộp thư đến và buộc chuỗi phải làm mới.
moveThreadToSpam(thread)GmailAppChuyển chuỗi này vào mục thư rác và buộc chuỗi làm mới.
moveThreadToTrash(thread)GmailAppChuyển chuỗi này vào thùng rác và buộc chuỗi làm mới.
moveThreadsToArchive(threads)GmailAppDi chuyển những luồng này đến kho lưu trữ và buộc các luồng làm mới.
moveThreadsToInbox(threads)GmailAppDi chuyển các chuỗi thư này vào hộp thư đến và buộc các chuỗi thư làm mới.
moveThreadsToSpam(threads)GmailAppChuyển những chuỗi này vào mục nội dung rác và buộc các chuỗi này làm mới.
moveThreadsToTrash(threads)GmailAppChuyển những chuỗi này vào thùng rác và buộc các chuỗi này làm mới.
refreshMessage(message)GmailAppTải lại thư 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).
refreshMessages(messages)GmailAppTải lại thư và trạng thái được 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).
refreshThread(thread)GmailAppTải lại chuỗi và trạng thái được 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).
refreshThreads(threads)GmailAppTải lại các luồng và trạng thái được 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).
search(query)GmailThread[]Tìm kiếm trong Gmail bằng cụm từ tìm kiếm cụ thể.
search(query, start, max)GmailThread[]Tìm kiếm trong Gmail bằng cụm từ tìm kiếm cụ thể.
sendEmail(recipient, subject, body)GmailAppGửi email.
sendEmail(recipient, subject, body, options)GmailAppGửi email có các đối số không bắt buộc.
setCurrentMessageAccessToken(accessToken)voidĐặt thông báo hiện tại mã truy cập cho phép tập lệnh truy cập vào các thuộc tính GmailMessage hiện tại.
starMessage(message)GmailAppThêm dấu sao vào thư này và buộc làm mới thư.
starMessages(messages)GmailAppThêm dấu sao vào các thư này và buộc làm mới thư.
unstarMessage(message)GmailAppXoá dấu sao khỏi thư này và buộc làm mới thư.
unstarMessages(messages)GmailAppXoá dấu sao khỏi các thư này và buộc làm mới thư.

Tài liệu chi tiết

createDraft(recipient, subject, body)

Tạo email nháp. 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.

// The code below creates a draft email with the current date and time.
var now = new Date();
GmailApp.createDraft("mike@example.com", "current time", "The time is: " + now.toString());

Tham số

TênLoạiMô tả
recipientStringdanh sách địa chỉ email được phân tách bằng dấu phẩy
subjectStringtiêu đề của email
bodyStringnội dung của email

Cầu thủ trả bóng

GmailDraft — Thư nháp mới được tạo trên Gmail

Ủ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


createDraft(recipient, subject, body, options)

Tạo email nháp có các đối số không bắt buộc. Email có thể chứa văn bản thuần tuý hoặc Nội dung HTML. Kích thước của email (bao gồm cả tiêu đề, nhưng không bao gồm tệp đính kèm) bị giới hạn.

// Create a draft email with a file from Google Drive attached as a PDF.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.createDraft('mike@example.com', 'Attachment example', 'Please see attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

Tham số

TênLoạiMô tả
recipientStringđịa chỉ của người nhận
subjectStringdòng tiêu đề
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 getAliases() trả về
htmlBodyStringnếu được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng HTML này của đố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 HTML nội dung nếu bạn có hình ảnh cùng dòng cho email của mình
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)

Cầu thủ trả bóng

GmailDraft — Thư nháp mới được tạo trên Gmail

Ủ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


createLabel(name)

Tạo một nhãn người dùng mới cho tên được cung cấp.

// Creates the label @FOO and logs label: FOO
Logger.log("label: " + GmailApp.createLabel("FOO"));

Tham số

TênLoạiMô tả
nameStringtên của nhãn mới

Cầu thủ trả bóng

GmailLabel – nhãn mới 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


deleteLabel(label)

Xoá nhãn đã chỉ định.

// Have to get the label by name first
var label = GmailApp.getUserLabelByName("FOO");
GmailApp.deleteLabel(label);

Tham số

TênLoạiMô tả
labelGmailLabelnhãn cần xoá

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


getAliases()

Lấy danh sách email được thiết lập làm email đại diện cho tài khoản này trong Gmail.

Bạn có thể gửi thư từ bất kỳ email đại diện nào trong số này bằng cách sử dụng mật khẩu "từ" đối số không bắt buộc.

// Log the aliases for this Gmail account and send an email as the first one.
var me = Session.getActiveUser().getEmail();
var aliases = GmailApp.getAliases();
Logger.log(aliases);
if (aliases.length > 0) {
  GmailApp.sendEmail(me, 'From an alias', 'A message from an alias!', {'from': aliases[0]});
} else {
  GmailApp.sendEmail(me, 'No aliases found', 'You have no aliases.');
}

Cầu thủ trả bóng

String[] — một loạt các bí danh cho tài khoả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/

Xem thêm


getDraft(draftId)

Truy xuất thư nháp theo mã nhận dạng.

Sử dụng thuộc tính này cùng với getId() trên thư nháp của Gmail.

// Get the first draft message in your drafts folder
var draft = GmailApp.getDrafts()[0];
// Get its ID
var draftId = draft.getId();
// Now fetch the same draft using that ID.
var draftById = GmailApp.getDraft(draftId);
// Should always log true as they should be the same message
Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());

Tham số

TênLoạiMô tả
draftIdStringmã bản nháp cần truy xuất

Cầu thủ trả bóng

GmailDraft – bản nháp có mã nhận dạng đã cho

Gửi

Error — nếu không tìm thấy bản nháp nào có mã đã cho

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

getDraftMessages()

Truy xuất tất cả thư nháp.

// Logs the number of draft messages
var drafts = GmailApp.getDraftMessages();
Logger.log(drafts.length);

Cầu thủ trả bóng

GmailMessage[] — một loạt các thư Gmail nháp

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

getDrafts()

Nhận tất cả thư nháp trong Gmail.

var drafts = GmailApp.getDrafts();
for (var i = 0; i < drafts.length; i++) {
  Logger.log(drafts[i].getId());
}

Cầu thủ trả bóng

GmailDraft[] — một loạt thư nháp trong Gmail

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

getInboxThreads()

Truy xuất tất cả các chuỗi trong Hộp thư đến, bất kể nhãn là gì.

Lệnh gọi này sẽ không thực hiện được khi kích thước của tất cả các luồng quá lớn, khiến hệ thống không xử lý được. Trong trường hợp kích thước chuỗi không xác định và có thể rất lớn, vui lòng sử dụng thuộc tính cuộc gọi và chỉ định phạm vi của luồng cần truy xuất trong mỗi lệnh gọi.

// Log the subject lines of your Inbox
var threads = GmailApp.getInboxThreads();
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Cầu thủ trả bóng

GmailThread[] — một loạt các chuỗi thư Gmail trong Hộp thư đến

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

getInboxThreads(start, max)

Truy xuất một loạt chuỗi trong Hộp thư đến, bất kể nhãn là gì.

// Log the subject lines of up to the first 50 emails in your Inbox
var threads = GmailApp.getInboxThreads(0, 50);
for (var i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Tham số

TênLoạiMô tả
startIntegerchỉ mục của chuỗi đầu tiên để truy xuất
maxIntegersố lượng luồng tối đa cần truy xuất

Cầu thủ trả bóng

GmailThread[] — một loạt các chuỗi thư Gmail trong Hộp thư đến

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

getInboxUnreadCount()

Lấy số chuỗi tin nhắn chưa đọc trong hộp thư đến.

Logger.log("Messages unread in inbox: " + GmailApp.getInboxUnreadCount());

Cầu thủ trả bóng

Integer — số chuỗi trong hộp thư đến có thư chưa đọc

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

getMessageById(id)

Nhận tin nhắn theo mã nhận dạng.

Sử dụng thuộc tính này cùng với getId() trên thư Gmail.

// Get the first message in the first thread of your inbox
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
// Get its ID
var messageId = message.getId();
// Now fetch the same message using that ID.
var messageById = GmailApp.getMessageById(messageId);
// Should always log true as they should be the same message
Logger.log(message.getSubject() == messageById.getSubject());

Tham số

TênLoạiMô tả
idStringmã nhận dạng của thư cần truy xuất

Cầu thủ trả bóng

GmailMessage – thông báo có mã nhận dạng đã cho

Gửi

Error – nếu không tìm thấy thông báo nào có mã nhận dạng đã cho

Ủ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


getMessagesForThread(thread)

Truy xuất tất cả thư trong chuỗi được chỉ định.

// Log all the subject lines in the first thread of your inbox
var thread = GmailApp.getInboxThreads(0, 1)[0];
var messages = GmailApp.getMessagesForThread(thread);
for (var i = 0 ; i < messages.length; i++) {
  Logger.log("subject: " + messages[i].getSubject());
}

Tham số

TênLoạiMô tả
threadGmailThreadchuỗi thư cần truy xuất

Cầu thủ trả bóng

GmailMessage[] – mảng tin nhắn tương ứng với chuỗi 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


getMessagesForThreads(threads)

Truy xuất tất cả tin nhắn trong chuỗi được chỉ định.

// Log the subject lines of all messages in the first two threads of your inbox
var thread = GmailApp.getInboxThreads(0, 2);
var messages = GmailApp.getMessagesForThreads(thread);
for (var i = 0 ; i < messages.length; i++) {
  for (var j = 0; j < messages[i].length; j++) {
    Logger.log("subject: " + messages[i][j].getSubject());
  }
}

Tham số

TênLoạiMô tả
threadsGmailThread[]các chuỗi tin nhắn cần truy xuất

Cầu thủ trả bóng

GmailMessage[][] – một mảng gồm các thông báo, trong đó mỗi mục trong mảng bên ngoài tương ứng với một luồng và mảng bên trong chứa các thông báo trong 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


getPriorityInboxThreads()

Truy xuất tất cả các chuỗi trong Hộp thư ưu tiên, bất kể nhãn.

Lệnh gọi này sẽ không thực hiện được khi kích thước của tất cả các luồng quá lớn, khiến hệ thống không xử lý được. Trong trường hợp kích thước chuỗi không xác định và có thể rất lớn, vui lòng sử dụng thuộc tính cuộc gọi và chỉ định phạm vi của luồng cần truy xuất trong mỗi lệnh gọi.

Logger.log("# of messages in your Priority Inbox: " +
           GmailApp.getPriorityInboxThreads().length);

Cầu thủ trả bóng

GmailThread[] — một loạt các chuỗi thư Gmail trong Hộp thư ưu tiên

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

getPriorityInboxThreads(start, max)

Truy xuất một loạt các chuỗi trong Hộp thư ưu tiên, bất kể nhãn.

// Will log some number 2 or less
Logger.log("# of messages in your Priority Inbox: " +
           GmailApp.getPriorityInboxThreads(0, 2).length);

Tham số

TênLoạiMô tả
startIntegerchỉ mục của chuỗi đầu tiên để truy xuất
maxIntegersố lượng luồng tối đa cần truy xuất

Cầu thủ trả bóng

GmailThread[] — một loạt các chuỗi thư Gmail trong Hộp thư ưu tiên

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

getPriorityInboxUnreadCount()

Lấy số chuỗi tin nhắn chưa đọc trong Hộp thư ưu tiên.

Logger.log("Number of unread emails in your Priority Inbox : " +
           GmailApp.getPriorityInboxUnreadCount());

Cầu thủ trả bóng

Integer — số chuỗi trong Hộp thư ưu tiên có thư chưa đọc

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

getSpamThreads()

Truy xuất tất cả các chuỗi thư rác, bất kể nhãn.

Lệnh gọi này sẽ không thực hiện được khi kích thước của tất cả các luồng quá lớn, khiến hệ thống không xử lý được. Trong trường hợp kích thước chuỗi không xác định và có thể rất lớn, vui lòng sử dụng thuộc tính cuộc gọi và chỉ định phạm vi của luồng cần truy xuất trong mỗi lệnh gọi.

Logger.log("# of total spam threads: " + GmailApp.getSpamThreads().length);

Cầu thủ trả bóng

GmailThread[] — một loạt các chuỗi email trên Gmail trong thư mục thư rác

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

getSpamThreads(start, max)

Truy xuất một loạt chuỗi thư rác, bất kể nhãn là gì.

// Will log a number at most 5
Logger.log("# of total spam threads: " + GmailApp.getSpamThreads(0, 5).length);

Tham số

TênLoạiMô tả
startIntegerchỉ mục của chuỗi đầu tiên để truy xuất
maxIntegersố lượng luồng tối đa cần truy xuất

Cầu thủ trả bóng

GmailThread[] — một loạt các chuỗi email trên Gmail trong thư mục thư rác

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

getSpamUnreadCount()

Lấy số lượng chuỗi tin nhắn rác chưa đọc.

// Unless you actually read stuff in your spam folder, this should be the same as
// the number of messages in your spam folder.
Logger.log("# unread threads that are spam: " + GmailApp.getSpamUnreadCount());

Cầu thủ trả bóng

Integer — số chuỗi tin nhắn rác có tin nhắn chưa đọc

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

getStarredThreads()

Truy xuất tất cả các chuỗi có gắn dấu sao, bất kể nhãn.

Lệnh gọi này sẽ không thực hiện được khi kích thước của tất cả các luồng quá lớn, khiến hệ thống không xử lý được. Trong trường hợp kích thước chuỗi không xác định và có thể rất lớn, vui lòng sử dụng thuộc tính cuộc gọi và chỉ định phạm vi của luồng cần truy xuất trong mỗi lệnh gọi.

// Logs the number of starred threads
Logger.log("# Starred threads: " + GmailApp.getStarredThreads().length);

Cầu thủ trả bóng

GmailThread[] — một loạt các chuỗi thư Gmail có gắn dấu sao

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

getStarredThreads(start, max)

Truy xuất một loạt chuỗi thư có gắn dấu sao, bất kể nhãn.

// Logs the number of starred threads to a maximum of 5
Logger.log("# Starred threads: " + GmailApp.getStarredThreads(0, 5).length);

Tham số

TênLoạiMô tả
startIntegerchỉ mục của chuỗi đầu tiên để truy xuất
maxIntegersố lượng luồng tối đa cần truy xuất

Cầu thủ trả bóng

GmailThread[] — một loạt các chuỗi thư Gmail có gắn dấu sao

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

getStarredUnreadCount()

Xem số lượng chuỗi tin nhắn chưa đọc được gắn dấu sao.

Logger.log("# unread and starred: " + GmailApp.getStarredUnreadCount());

Cầu thủ trả bóng

Integer — số lượng chuỗi tin nhắn có gắn dấu sao có tin nhắn chưa đọc

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

getThreadById(id)

Nhận một chuỗi theo mã nhận dạng.

Sử dụng thuộc tính này cùng với getId() trên các chuỗi Gmail.

// Gets the first inbox thread.
const firstThread = GmailApp.getInboxThreads(0,1)[0];
// Gets the same thread by ID.
const threadById = GmailApp.getThreadById(firstThread.getId());
// Verifies that they are the same.
console.log(firstThread.getFirstMessageSubject() === threadById.getFirstMessageSubject());

Tham số

TênLoạiMô tả
idStringMã nhận dạng của luồng cần truy xuất.

Cầu thủ trả bóng

GmailThread – Luồng có mã nhận dạng đã cho hoặc null nếu không tìm thấ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


getTrashThreads()

Truy xuất tất cả các chuỗi trong thùng rác, bất kể nhãn là gì.

Lệnh gọi này sẽ không thực hiện được khi kích thước của tất cả các luồng quá lớn, khiến hệ thống không xử lý được. Trong trường hợp kích thước chuỗi không xác định và có thể rất lớn, vui lòng sử dụng thuộc tính cuộc gọi và chỉ định phạm vi của luồng cần truy xuất trong mỗi lệnh gọi.

Logger.log("# of total trash threads: " + GmailApp.getTrashThreads().length);

Cầu thủ trả bóng

GmailThread[] — một loạt các chuỗi thư Gmail trong thùng rác

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

getTrashThreads(start, max)

Truy xuất một loạt các chuỗi thùng rác, bất kể nhãn là gì.

// Will log a number at most 5
Logger.log("# of total trash threads: " + GmailApp.getTrashThreads(0, 5).length);

Tham số

TênLoạiMô tả
startIntegerchỉ mục của chuỗi đầu tiên để truy xuất
maxIntegersố lượng luồng tối đa cần truy xuất

Cầu thủ trả bóng

GmailThread[] — một loạt các chuỗi thư Gmail trong thùng rác

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

getUserLabelByName(name)

Truy xuất nhãn đã cho tên nhãn.

var labelObject = GmailApp.getUserLabelByName("myLabel");

Tham số

TênLoạiMô tả
nameStringtên nhãn cần truy xuất

Cầu thủ trả bóng

GmailLabel — nhãn Gmail có tên được cung cấp

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

getUserLabels()

Truy xuất danh sách nhãn do người dùng tạo.

// Logs all of the names of your labels
var labels = GmailApp.getUserLabels();
for (var i = 0; i < labels.length; i++) {
  Logger.log("label: " + labels[i].getName());
}

Cầu thủ trả bóng

GmailLabel[] — mảng nhãn do người dùng 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/

markMessageRead(message)

Đánh dấu thông báo này là đã đọc và buộc thư làm mới.

// Mark the first message in the first thread of your inbox as read
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageRead(message);

Tham số

TênLoạiMô tả
messageGmailMessagethư cần đánh dấu là đã đọc

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


markMessageUnread(message)

Đánh dấu thông báo này là chưa đọc và buộc thư làm mới.

// Mark the first message in the first thread of your inbox as unread
var message = GmailApp.getInboxThreads(0, 1)[0].getMessages()[0];
GmailApp.markMessageUnread(message);

Tham số

TênLoạiMô tả
messageGmailMessagethư cần đánh dấu là chưa đọc

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


markMessagesRead(messages)

Đánh dấu những thư này là đã đọc và buộc các thư làm mới.

// Mark first three messages in the first inbox thread as read.
// Assumes that the first inbox thread has 3 messages in it.
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesRead(thread.getMessages());

Tham số

TênLoạiMô tả
messagesGmailMessage[]một loạt thư để đánh dấu là đã đọc

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


markMessagesUnread(messages)

Đánh dấu những thư này là chưa đọc và buộc các thư làm mới.

// Mark first three messages in the first inbox thread as unread.
// Assumes that the first inbox thread has 3 messages in it
var threadMessages = GmailApp.getInboxThreads(0, 1)[0].getMessages();
var messages = [threadMessages[0], threadMessages[1], threadMessages[2]];
GmailApp.markMessagesUnread(thread.getMessages());

Tham số

TênLoạiMô tả
messagesGmailMessage[]một loạt tin nhắn để đánh dấu là chưa đọc

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


markThreadImportant(thread)

Đánh dấu luồng này là quan trọng và buộc luồng làm mới.

// Marks first inbox thread as important
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadImportant(thread);

Tham số

TênLoạiMô tả
threadGmailThreadchuỗi thư cần đánh dấu là quan trọng

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


markThreadRead(thread)

Đánh dấu chuỗi này là đã đọc và buộc chuỗi làm mới.

// Marks first inbox thread as read
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadRead(thread);

Tham số

TênLoạiMô tả
threadGmailThreadchuỗi thư cần đánh dấu là đã đọc

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


markThreadUnimportant(thread)

Đánh dấu luồng này là không quan trọng và buộc luồng làm mới.

// Marks first inbox thread as unimportant
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnimportant(thread);

Tham số

TênLoạiMô tả
threadGmailThreadđánh dấu chuỗi là không quan trọng

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


markThreadUnread(thread)

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

// Marks first inbox thread as unread
var thread = GmailApp.getInboxThreads(0, 1)[0];
GmailApp.markThreadUnread(thread);

Tham số

TênLoạiMô tả
threadGmailThreadchuỗi thư cần đánh dấu là chưa đọc

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


markThreadsImportant(threads)

Đánh dấu những luồng này là quan trọng và buộc các luồng này làm mới.

// Marks first two threads in inbox as important
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsImportant(threads);

Tham số

TênLoạiMô tả
threadsGmailThread[]một mảng chuỗi để đánh dấu là quan trọng

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


markThreadsRead(threads)

Đánh dấu những luồng này là đã đọc và buộc các luồng làm mới.

// Marks first two threads in inbox as read
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsRead(threads);

Tham số

TênLoạiMô tả
threadsGmailThread[]một mảng chuỗi để đánh dấu là đã đọc

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


markThreadsUnimportant(threads)

Đánh dấu những luồng này là không quan trọng và buộc các luồng này làm mới.

// Marks first two threads in inbox as unimportant
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnimportant(threads);

Tham số

TênLoạiMô tả
threadsGmailThread[]một mảng chuỗi để đánh dấu là không quan trọng

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


markThreadsUnread(threads)

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

// Marks first two threads in inbox as unread
var threads = GmailApp.getInboxThreads(0, 2);
GmailApp.markThreadsUnread(threads);

Tham số

TênLoạiMô tả
threadsGmailThread[]một mảng chuỗi tin nhắn để đánh dấu là chưa đọc

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


moveMessageToTrash(message)

Chuyển thư vào thùng rác và buộc làm mới thư.

// Move the first message in your inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var firstMessage = firstThread.getMessages()[0];
GmailApp.moveMessageToTrash(firstMessage);

Tham số

TênLoạiMô tả
messageGmailMessagethư sẽ bị chuyển vào thùng rác

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail (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


moveMessagesToTrash(messages)

Chuyển các thư được chỉ định vào thùng rác và buộc thư làm mới.

// Move first two messages in your inbox to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var messages = firstThread.getMessages();
var toDelete = [messages[0], messages[1]];
GmailApp.moveMessagesToTrash(toDelete);

Tham số

TênLoạiMô tả
messagesGmailMessage[]thư sẽ bị chuyển vào thùng rác

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail (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


moveThreadToArchive(thread)

Di chuyển luồng này đến mục lưu trữ và buộc luồng làm mới.

// Archive the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToArchive(firstThread);

Tham số

TênLoạiMô tả
threadGmailThreadchuỗi bài đăng sẽ được lưu trữ

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


moveThreadToInbox(thread)

Di chuyển chuỗi thư này vào hộp thư đến và buộc chuỗi phải làm mới.

// Find a thread not already in your inbox
var thread = GmailApp.search("-in:inbox")[0]; // Get the first one
GmailApp.moveThreadToInbox(thread);

Tham số

TênLoạiMô tả
threadGmailThreadchuỗi thư cần chuyển vào hộp thư đến

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


moveThreadToSpam(thread)

Chuyển chuỗi này vào mục thư rác và buộc chuỗi làm mới.

// Tag first thread in inbox as spam
var firstThread = GmailApp.getInboxThreads(0,1)[0];
GmailApp.moveThreadToSpam(firstThread);

Tham số

TênLoạiMô tả
threadGmailThreadchuỗi thư cần chuyển vào mục thư rác

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


moveThreadToTrash(thread)

Chuyển chuỗi này vào thùng rác và buộc chuỗi làm mới.

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

Tham số

TênLoạiMô tả
threadGmailThreadchuỗi cần chuyển vào thùng rác

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


moveThreadsToArchive(threads)

Di chuyển những luồng này đến kho lưu trữ và buộc các luồng làm mới.

// Move first two threads in your inbox to the archive
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToArchive(firstTwoThreads);

Tham số

TênLoạiMô tả
threadsGmailThread[]một mảng chuỗi cần lưu trữ

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


moveThreadsToInbox(threads)

Di chuyển các chuỗi thư này vào hộp thư đến và buộc các chuỗi thư làm mới.

// Find two threads not already in your inbox
var firstTwoThreads = GmailApp.search("-in:inbox", 0, 2);
GmailApp.moveThreadsToInbox(firstTwoThreads);

Tham số

TênLoạiMô tả
threadsGmailThread[]một mảng chuỗi thư cần được chuyển vào hộp thư đến

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


moveThreadsToSpam(threads)

Chuyển những chuỗi này vào mục nội dung rác và buộc các chuỗi này làm mới.

// Move first two threads in your inbox to spam
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToSpam(firstTwoThreads);

Tham số

TênLoạiMô tả
threadsGmailThread[]một loạt chuỗi thảo luận cần được chuyển vào phần nội dung rác

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


moveThreadsToTrash(threads)

Chuyển những chuỗi này vào thùng rác và buộc các chuỗi này làm mới.

// Move first two threads in your inbox to trash
var firstTwoThreads = GmailApp.getInboxThreads(0,2);
GmailApp.moveThreadsToTrash(firstTwoThreads);

Tham số

TênLoạiMô tả
threadsGmailThread[]một mảng luồng cần được chuyển vào thùng rác

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


refreshMessage(message)

Tải lại thư 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 firstThread = GmailApp.getInboxThreads(0,1)[0];
var firstMessage = firstThread.getMessages()[0];
// ...Do something that may take a while here....
GmailApp.refreshMessage(firstMessage);
// ...Do more stuff with firstMessage...

Tham số

TênLoạiMô tả
messageGmailMessagetin nhắn cần được làm mới

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


refreshMessages(messages)

Tải lại thư và trạng thái được 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 firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 2);
// ...Do something that may take a while here....
GmailApp.refreshMessages(coupleOfMessages);
// ...Do more stuff with coupleOfMessages...

Tham số

TênLoạiMô tả
messagesGmailMessage[]tin nhắn cần được làm mới

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


refreshThread(thread)

Tải lại chuỗi và trạng thái được 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 firstThread = GmailApp.getInboxThreads(0,1)[0];
// ...Do something that may take a while here....
GmailApp.refreshThread(firstThread);
// ... Do more stuff with the thread ...

Tham số

TênLoạiMô tả
threadGmailThreadchuỗi bài đăng sẽ được làm mới

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


refreshThreads(threads)

Tải lại các luồng và trạng thái được 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 threads = GmailApp.getInboxThreads(0, 3);
// ...Do something that may take a while here....
GmailApp.refreshThreads(threads);
// ... Do more stuff with threads ...

Tham số

TênLoạiMô tả
threadsGmailThread[]các luồng cần làm mới

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


search(query)

Tìm kiếm trong Gmail bằng cụm từ tìm kiếm cụ thể.

Lệnh gọi này sẽ không thực hiện được khi kích thước của tất cả các luồng quá lớn, khiến hệ thống không xử lý được. Trong trường hợp kích thước chuỗi không xác định và có thể rất lớn, vui lòng sử dụng thuộc tính cuộc gọi và chỉ định phạm vi của luồng cần truy xuất trong mỗi lệnh gọi.

// Find starred messages with subject IMPORTANT
var threads = GmailApp.search('is:starred subject:"IMPORTANT"');

Tham số

TênLoạiMô tả
queryStringcụm từ tìm kiếm, giống như cách bạn nhập vào Gmail

Cầu thủ trả bóng

GmailThread[] — một loạt các chuỗi Gmail khớp với truy vấ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/

search(query, start, max)

Tìm kiếm trong Gmail bằng cụm từ tìm kiếm cụ thể.

// Find starred messages with subject IMPORTANT and return second batch of 10.
// Assumes there are at least 11 of them, otherwise this will return an empty array.
var threads = GmailApp.search('is:starred subject:"IMPORTANT"', 10, 10);

Tham số

TênLoạiMô tả
queryStringcụm từ tìm kiếm, giống như cách bạn nhập vào Gmail
startIntegerchỉ mục của chuỗi bắt đầu
maxIntegersố lượng luồng tối đa cần trả về

Cầu thủ trả bóng

GmailThread[] — một loạt các chuỗi Gmail khớp với truy vấ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/

sendEmail(recipient, subject, body)

Gửi email. 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.

// The code below will send an email with the current date and time.
var now = new Date();
GmailApp.sendEmail("mike@example.com", "current time", "The time is: " + now.toString());

Tham số

TênLoạiMô tả
recipientStringdanh sách địa chỉ email được phân tách bằng dấu phẩy
subjectStringtiêu đề của email (tối đa 250 ký tự)
bodyStringnội dung của email

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


sendEmail(recipient, subject, body, options)

Gửi email có các đối số không bắt buộc. Email có thể chứa văn bản thuần tuý hoặc HTML nội dung. Kích thước của email (bao gồm cả tiêu đề, nhưng không bao gồm tệp đính kèm) bị giới hạn.

// Send an email with a file from Google Drive attached as a PDF.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
GmailApp.sendEmail('mike@example.com', 'Attachment example', 'Please see the attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

Tham số

TênLoạiMô tả
recipientStringđịa chỉ của người nhận
subjectStringdòng chủ đề (tối đa 250 ký 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 getAliases() trả về
htmlBodyStringnếu được đặt, các thiết bị có khả năng hiển thị HTML sẽ sử dụng HTML này của đố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 HTML nội dung nếu bạn có hình ảnh cùng dòng cho email của mình
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)

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


setCurrentMessageAccessToken(accessToken)

Đặt thông báo hiện tại mã truy cập cho phép tập lệnh truy cập vào các thuộc tính GmailMessage hiện tại.

Chỉ những dự án Tiện ích bổ sung của Google Workspace sử dụng phạm vi thư hiện tại trên Gmail yêu cầu phương thức này.

function handleAddonActionEvent(e) {
  var accessToken = e.messageMetadata.accessToken;
  var messageId = e.messageMetadata.messageId;
  GmailApp.setCurrentMessageAccessToken(accessToken);
  var mailMessage = GmailApp.getMessageById(messageId);
  // Do something with mailMessage
}

Tham số

TênLoạiMô tả
accessTokenStringmã truy cập tạm thời nhận được từ đối tượng sự kiện hành động của tiện ích bổ sung Gmail.

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

starMessage(message)

Thêm dấu sao vào thư này và buộc làm mới thư.

// Stars the first message in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
GmailApp.starMessage(message);

Tham số

TênLoạiMô tả
messageGmailMessagetin nhắn cần gắn dấu sao

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


starMessages(messages)

Thêm dấu sao vào các thư này và buộc làm mới thư.

// Stars the first three messages in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.starMessages(coupleOfMessages);

Tham số

TênLoạiMô tả
messagesGmailMessage[]một loạt tin nhắn để gắn dấu sao

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


unstarMessage(message)

Xoá dấu sao khỏi thư này và buộc làm mới thư.

// Unstars the first message in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
GmailApp.unstarMessage(message);

Tham số

TênLoạiMô tả
messageGmailMessagebỏ gắn dấu sao cho tin nhắn

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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


unstarMessages(messages)

Xoá dấu sao khỏi các thư này và buộc làm mới thư.

// Unstars the first three messages in the first thread in your inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var coupleOfMessages = firstThread.getMessages().slice(0, 3);
GmailApp.unstarMessages(coupleOfMessages);

Tham số

TênLoạiMô tả
messagesGmailMessage[]một loạt tin nhắn cần bỏ gắn dấu sao

Cầu thủ trả bóng

GmailApp – dịch vụ Gmail, 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

Các phương thức ngừng hoạt động