Nhãn do người dùng tạo trong tài khoản Gmail của người dùng.
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
addToThread(thread) | GmailLabel | Thêm nhãn này vào luồng đã cho và buộc luồng làm mới (GmailThread.refresh() ). |
addToThreads(threads) | GmailLabel | Thêm nhãn này vào các luồng đã cho và buộc các luồng làm mới. |
deleteLabel() | void | Xoá nhãn này. |
getName() | String | Xem tên của nhãn này. |
getThreads() | GmailThread[] | Lấy các chuỗi được đánh dấu bằng nhãn này. |
getThreads(start, max) | GmailThread[] | Lấy một loạt chuỗi được đánh dấu bằng nhãn này. |
getUnreadCount() | Integer | Xem số lượng chuỗi tin nhắn chưa đọc được gắn nhãn này. |
removeFromThread(thread) | GmailLabel | Xoá nhãn này khỏi chuỗi đã cho và buộc chuỗi làm mới. |
removeFromThreads(threads) | GmailLabel | Xoá nhãn này khỏi các chuỗi đã cho và buộc các chuỗi làm mới. |
Tài liệu chi tiết
addToThread(thread)
Thêm nhãn này vào luồng đã cho và buộc luồng làm mới (GmailThread.refresh()
).
// label the first thread in the inbox with the label MyLabel var label = GmailApp.getUserLabelByName("MyLabel"); var firstThread = GmailApp.getInboxThreads(0,1)[0]; label.addToThread(firstThread);
Tham số
Tên | Loại | Mô tả |
---|---|---|
thread | GmailThread | Chuỗi cần gắn nhãn. |
Cầu thủ trả bóng
GmailLabel
— Nhãn này để tạo chuỗi.
Ủy quyền
Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:
-
https://mail.google.com/
Xem thêm
addToThreads(threads)
Thêm nhãn này vào các luồng đã cho và buộc các luồng làm mới. Bạn có thể thêm nhãn cho tối đa 100 luồng cho mỗi lô.
// label the first three threads in the inbox with the label MyLabel var label = GmailApp.getUserLabelByName("MyLabel"); var threads = GmailApp.getInboxThreads(0,3); label.addToThreads(threads);
Tham số
Tên | Loại | Mô tả |
---|---|---|
threads | GmailThread[] | Một mảng luồng cần được gắn nhãn. |
Cầu thủ trả bóng
GmailLabel
— Nhãn này để tạo chuỗi.
Ủy quyền
Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:
-
https://mail.google.com/
Xem thêm
deleteLabel()
Xoá nhãn này.
var label = GmailApp.getUserLabelByName("MyLabel"); label.deleteLabel();
Gửi
Error
– nếu không thể xoá nhã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/
Xem thêm
getName()
Xem tên của nhãn này.
var label = GmailApp.getUserLabelByName("MyLabel"); Logger.log(label.getName()); //logs MyLabel
Cầu thủ trả bóng
String
— Tên nhã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/
getThreads()
Lấy các chuỗi được đánh dấu bằng nhãn này.
Lệnh gọi này 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. Địa điểm
kích thước chuỗi không xác định và có thể rất lớn, vui lòng sử dụng getThreads(start, max)
và chỉ định phạm vi của chuỗi cần truy xuất trong mỗi lệnh gọi.
// Log the subject lines of the threads labeled with MyLabel var label = GmailApp.getUserLabelByName("MyLabel"); var threads = label.getThreads(); for (var i = 0; i < threads.length; i++) { Logger.log(threads[i].getFirstMessageSubject()); }
Cầu thủ trả bóng
GmailThread[]
— Một mảng các luồng được đánh dấu bằng nhãn này.
Ủy quyền
Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:
-
https://mail.google.com/
getThreads(start, max)
Lấy một loạt chuỗi được đánh dấu bằng nhãn này.
// log the subject lines of up to the first 30 threads with the label MyLabel var label = GmailApp.getUserLabelByName("MyLabel"); var threads = label.getThreads(0, 30); 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 luồng 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 mảng các luồng được đánh dấu bằng nhãn này.
Ủy quyền
Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:
-
https://mail.google.com/
getUnreadCount()
Xem số lượng chuỗi tin nhắn chưa đọc được gắn nhãn này.
// log the number of unread threads labeled with MyLabel var label = GmailApp.getUserLabelByName("MyLabel"); Logger.log(label.getUnreadCount());
Cầu thủ trả bóng
Integer
— Số chuỗi có gắn 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/
removeFromThread(thread)
Xoá nhãn này khỏi chuỗi đã cho và buộc chuỗi làm mới.
// remove the label MyLabel from the first thread in the inbox var label = GmailApp.getUserLabelByName("MyLabel"); var firstThread = GmailApp.getInboxThreads(0,1)[0]; label.removeFromThread(firstThread);
Tham số
Tên | Loại | Mô tả |
---|---|---|
thread | GmailThread | Chuỗi cuộc trò chuyện này chưa được gắn nhãn. |
Cầu thủ trả bóng
GmailLabel
— Nhãn này để tạo chuỗi.
Ủy quyền
Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:
-
https://mail.google.com/
Xem thêm
removeFromThreads(threads)
Xoá nhãn này khỏi các chuỗi đã cho và buộc các chuỗi làm mới. Bạn có thể xoá cho tối đa 100 chuỗi mỗi lô.
// remove the label MyLabel from the first three threads in the inbox var label = GmailApp.getUserLabelByName("MyLabel"); var threads = GmailApp.getInboxThreads(0,3); label.removeFromThreads(threads);
Tham số
Tên | Loại | Mô tả |
---|---|---|
threads | GmailThread[] | Một mảng chuỗi cần gắn nhãn. |
Cầu thủ trả bóng
GmailLabel
— Nhãn này để tạo chuỗi.
Ủy quyền
Những tập lệnh dùng phương thức này yêu cầu uỷ quyền với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây trong API REST liên quan:
-
https://mail.google.com/