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ức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
createDraft(recipient, subject, body) | GmailDraft | Tạo email nháp. |
createDraft(recipient, subject, body, options) | GmailDraft | Tạo email nháp có các đối số không bắt buộc. |
createLabel(name) | GmailLabel | Tạo một nhãn người dùng mới cho tên được cung cấp. |
deleteLabel(label) | GmailApp | Xoá 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) | GmailDraft | Truy 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() | Integer | Lấy số chuỗi tin nhắn chưa đọc trong hộp thư đến. |
getMessageById(id) | GmailMessage | Nhậ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() | Integer | Lấ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() | Integer | Lấ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() | Integer | Xem số lượng chuỗi tin nhắn chưa đọc được gắn dấu sao. |
getThreadById(id) | GmailThread | Nhậ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) | GmailLabel | Truy 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) | GmailApp | Chuyển thư vào thùng rác và buộc làm mới thư. |
moveMessagesToTrash(messages) | GmailApp | Chuyển các thư được chỉ định vào thùng rác và buộc thư làm mới. |
moveThreadToArchive(thread) | GmailApp | Di chuyển luồng này đến mục lưu trữ và buộc luồng làm mới. |
moveThreadToInbox(thread) | GmailApp | 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. |
moveThreadToSpam(thread) | GmailApp | Chuyển chuỗi này vào mục thư rác và buộc chuỗi làm mới. |
moveThreadToTrash(thread) | GmailApp | Chuyển chuỗi này vào thùng rác và buộc chuỗi làm mới. |
moveThreadsToArchive(threads) | GmailApp | 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. |
moveThreadsToInbox(threads) | GmailApp | 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. |
moveThreadsToSpam(threads) | GmailApp | 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. |
moveThreadsToTrash(threads) | GmailApp | 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. |
refreshMessage(message) | GmailApp | 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). |
refreshMessages(messages) | GmailApp | 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). |
refreshThread(thread) | GmailApp | 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). |
refreshThreads(threads) | GmailApp | 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). |
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) | GmailApp | Gửi email. |
sendEmail(recipient, subject, body, options) | GmailApp | Gử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) | GmailApp | Thêm dấu sao vào thư này và buộc làm mới thư. |
starMessages(messages) | GmailApp | Thêm dấu sao vào các thư này và buộc làm mới thư. |
unstarMessage(message) | GmailApp | Xoá dấu sao khỏi thư này và buộc làm mới thư. |
unstarMessages(messages) | GmailApp | Xoá 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ên | Loại | Mô tả |
---|---|---|
recipient | String | danh sách địa chỉ email được phân tách bằng dấu phẩy |
subject | String | tiêu đề của email |
body | String | nộ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ên | Loại | Mô tả |
---|---|---|
recipient | String | địa chỉ của người nhận |
subject | String | dòng tiêu đề |
body | String | nội dung email |
options | Object | đố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ên | Loại | Mô tả |
---|---|---|
attachments | BlobSource[] | một mảng tệp để gửi cùng với email |
bcc | String | danh sách địa chỉ email được phân tách bằng dấu phẩy tới BCC |
cc | String | danh sách địa chỉ email được phân tách bằng dấu phẩy để gửi CC |
from | String | địa chỉ email phải được gửi từ đó
trong các giá trị được getAliases() trả về |
htmlBody | String | nế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 |
inlineImages | Object | đố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" /> |
name | String | tên người gửi email (mặc định: tên của người dùng) |
replyTo | String | đị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ên | Loại | Mô tả |
---|---|---|
name | String | tê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ên | Loại | Mô tả |
---|---|---|
label | GmailLabel | nhã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ên | Loại | Mô tả |
---|---|---|
draftId | String | mã 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ên | Loại | Mô tả |
---|---|---|
start | Integer | chỉ mục của chuỗi đầu tiên để truy xuất |
max | Integer | số 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ên | Loại | Mô tả |
---|---|---|
id | String | mã 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ên | Loại | Mô tả |
---|---|---|
thread | GmailThread | chuỗ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ên | Loại | Mô tả |
---|---|---|
threads | GmailThread[] | 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ên | Loại | Mô tả |
---|---|---|
start | Integer | chỉ mục của chuỗi đầu tiên để truy xuất |
max | Integer | số 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ên | Loại | Mô tả |
---|---|---|
start | Integer | chỉ mục của chuỗi đầu tiên để truy xuất |
max | Integer | số 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ên | Loại | Mô tả |
---|---|---|
start | Integer | chỉ mục của chuỗi đầu tiên để truy xuất |
max | Integer | số 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ên | Loại | Mô tả |
---|---|---|
id | String | Mã 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ên | Loại | Mô tả |
---|---|---|
start | Integer | chỉ mục của chuỗi đầu tiên để truy xuất |
max | Integer | số 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ên | Loại | Mô tả |
---|---|---|
name | String | tê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ên | Loại | Mô tả |
---|---|---|
message | GmailMessage | 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
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ên | Loại | Mô tả |
---|---|---|
message | GmailMessage | 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
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ên | Loại | Mô tả |
---|---|---|
messages | GmailMessage[] | 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ên | Loại | Mô tả |
---|---|---|
messages | GmailMessage[] | 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ên | Loại | Mô tả |
---|---|---|
thread | GmailThread | chuỗ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ên | Loại | Mô tả |
---|---|---|
thread | GmailThread | chuỗ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ên | Loại | Mô tả |
---|---|---|
thread | GmailThread | đá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ên | Loại | Mô tả |
---|---|---|
thread | GmailThread | chuỗ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ên | Loại | Mô tả |
---|---|---|
threads | GmailThread[] | 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ên | Loại | Mô tả |
---|---|---|
threads | GmailThread[] | 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ên | Loại | Mô tả |
---|---|---|
threads | GmailThread[] | 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ên | Loại | Mô tả |
---|---|---|
threads | GmailThread[] | 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ên | Loại | Mô tả |
---|---|---|
message | GmailMessage | 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
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ên | Loại | Mô tả |
---|---|---|
messages | GmailMessage[] | 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ên | Loại | Mô tả |
---|---|---|
thread | GmailThread | chuỗ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ên | Loại | Mô tả |
---|---|---|
thread | GmailThread | chuỗ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ên | Loại | Mô tả |
---|---|---|
thread | GmailThread | chuỗ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ên | Loại | Mô tả |
---|---|---|
thread | GmailThread | chuỗ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ên | Loại | Mô tả |
---|---|---|
threads | GmailThread[] | 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ên | Loại | Mô tả |
---|---|---|
threads | GmailThread[] | 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ên | Loại | Mô tả |
---|---|---|
threads | GmailThread[] | 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ên | Loại | Mô tả |
---|---|---|
threads | GmailThread[] | 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ên | Loại | Mô tả |
---|---|---|
message | GmailMessage | 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
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ên | Loại | Mô tả |
---|---|---|
messages | GmailMessage[] | 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ên | Loại | Mô tả |
---|---|---|
thread | GmailThread | chuỗ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ên | Loại | Mô tả |
---|---|---|
threads | GmailThread[] | 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ên | Loại | Mô tả |
---|---|---|
query | String | cụ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ên | Loại | Mô tả |
---|---|---|
query | String | cụm từ tìm kiếm, giống như cách bạn nhập vào Gmail |
start | Integer | chỉ mục của chuỗi bắt đầu |
max | Integer | số 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ên | Loại | Mô tả |
---|---|---|
recipient | String | danh sách địa chỉ email được phân tách bằng dấu phẩy |
subject | String | tiêu đề của email (tối đa 250 ký tự) |
body | String | nộ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ên | Loại | Mô tả |
---|---|---|
recipient | String | địa chỉ của người nhận |
subject | String | dòng chủ đề (tối đa 250 ký tự) |
body | String | nội dung email |
options | Object | đố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ên | Loại | Mô tả |
---|---|---|
attachments | BlobSource[] | một mảng tệp để gửi cùng với email |
bcc | String | danh sách địa chỉ email được phân tách bằng dấu phẩy tới BCC |
cc | String | danh sách địa chỉ email được phân tách bằng dấu phẩy để gửi CC |
from | String | địa chỉ email phải được gửi từ đó
trong các giá trị được getAliases() trả về |
htmlBody | String | nế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 |
inlineImages | Object | đố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" /> |
name | String | tên người gửi email (mặc định: tên của người dùng) |
noReply | Boolean | true 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 |
replyTo | String | đị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ên | Loại | Mô tả |
---|---|---|
accessToken | String | mã 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ên | Loại | Mô tả |
---|---|---|
message | GmailMessage | tin 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ên | Loại | Mô tả |
---|---|---|
messages | GmailMessage[] | 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ên | Loại | Mô tả |
---|---|---|
message | GmailMessage | bỏ 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ên | Loại | Mô tả |
---|---|---|
messages | GmailMessage[] | 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/