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 | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
add | Gmail | Thêm nhãn này vào chuỗi đã cho và buộc chuỗi làm mới (Gmail ). |
add | Gmail | Thêm nhãn này vào các luồng đã cho và buộc các luồng làm mới. |
delete | void | Xoá nhãn này. |
get | String | Lấy mã nhận dạng của nhãn này. |
get | String | Lấy tên của nhãn này. |
get | Gmail | Lấy các luồng được đánh dấu bằng nhãn này. |
get | Gmail | Lấy một dải các chuỗi được đánh dấu bằng nhãn này. |
get | Integer | Lấy số lượng chuỗi chưa đọc được gắn nhãn này. |
remove | Gmail | Xoá nhãn này khỏi luồng đã cho và buộc luồng làm mới. |
remove | Gmail | 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
add To Thread(thread)
Thêm nhãn này vào chuỗi đã cho và buộc chuỗi làm mới (Gmail
).
// label the first thread in the inbox with the label MyLabel const label = GmailApp.getUserLabelByName('MyLabel'); const firstThread = GmailApp.getInboxThreads(0, 1)[0]; label.addToThread(firstThread);
Thông số
Tên | Loại | Mô tả |
---|---|---|
thread | Gmail | Luồng cần được gắn nhãn. |
Cầu thủ trả bóng
Gmail
– Nhãn này dùng để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ REST API có liên quan:
-
https://mail.google.com/
Xem thêm
add To Threads(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 chuỗi email trong mỗi lô.
// label the first three threads in the inbox with the label MyLabel const label = GmailApp.getUserLabelByName('MyLabel'); const threads = GmailApp.getInboxThreads(0, 3); label.addToThreads(threads);
Thông số
Tên | Loại | Mô tả |
---|---|---|
threads | Gmail | Một mảng các luồng cần được gắn nhãn. |
Cầu thủ trả bóng
Gmail
– Nhãn này dùng để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ REST API có liên quan:
-
https://mail.google.com/
Xem thêm
delete Label()
Xoá nhãn này.
const label = GmailApp.getUserLabelByName('MyLabel'); label.deleteLabel();
Gửi
Error
– nếu không thể xoá nhãn
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ REST API có liên quan:
-
https://mail.google.com/
Xem thêm
get Id()
Lấy mã nhận dạng của nhãn này.
const label = GmailApp.getUserLabelByName('MyLabel'); console.log(label.getId());
Cầu thủ trả bóng
String
– Mã của nhãn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ REST API có liên quan:
-
https://mail.google.com/
get Name()
Lấy tên của nhãn này.
const label = GmailApp.getUserLabelByName('MyLabel'); Logger.log(label.getName()); // logs MyLabel
Cầu thủ trả bóng
String
– Tên của nhãn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ REST API có liên quan:
-
https://mail.google.com/
get Threads()
Lấy các luồng được đánh dấu bằng nhãn này.
Các lệnh gọi này sẽ không thành công khi kích thước của tất cả các luồng quá lớn để hệ thống xử lý. Nếu không biết kích thước luồng và kích thước này có thể rất lớn, vui lòng sử dụng get
và chỉ định các dải luồng cần truy xuất trong mỗi lệnh gọi.
// Log the subject lines of the threads labeled with MyLabel const label = GmailApp.getUserLabelByName('MyLabel'); const threads = label.getThreads(); for (let i = 0; i < threads.length; i++) { Logger.log(threads[i].getFirstMessageSubject()); }
Cầu thủ trả bóng
Gmail
– Một mảng các luồng được đánh dấu bằng nhãn này.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ REST API có liên quan:
-
https://mail.google.com/
get Threads(start, max)
Lấy một dải các 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 const label = GmailApp.getUserLabelByName('MyLabel'); const threads = label.getThreads(0, 30); for (let i = 0; i < threads.length; i++) { Logger.log(threads[i].getFirstMessageSubject()); }
Thông 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
Gmail
– Một mảng các luồng được đánh dấu bằng nhãn này.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ REST API có liên quan:
-
https://mail.google.com/
get Unread Count()
Lấy số lượng chuỗi chưa đọc được gắn nhãn này.
// log the number of unread threads labeled with MyLabel const label = GmailApp.getUserLabelByName('MyLabel'); Logger.log(label.getUnreadCount());
Cầu thủ trả bóng
Integer
– Số lượng chuỗi tin nhắn chưa đọc được gắn nhãn.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ REST API có liên quan:
-
https://mail.google.com/
remove From Thread(thread)
Xoá nhãn này khỏi luồng đã cho và buộc luồng làm mới.
// remove the label MyLabel from the first thread in the inbox const label = GmailApp.getUserLabelByName('MyLabel'); const firstThread = GmailApp.getInboxThreads(0, 1)[0]; label.removeFromThread(firstThread);
Thông số
Tên | Loại | Mô tả |
---|---|---|
thread | Gmail | Chuỗi sẽ không được gắn nhãn. |
Cầu thủ trả bóng
Gmail
– Nhãn này dùng để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ REST API có liên quan:
-
https://mail.google.com/
Xem thêm
remove From Threads(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á nhãn cho tối đa 100 chuỗi email trong mỗi lô.
// remove the label MyLabel from the first three threads in the inbox const label = GmailApp.getUserLabelByName('MyLabel'); const threads = GmailApp.getInboxThreads(0, 3); label.removeFromThreads(threads);
Thông số
Tên | Loại | Mô tả |
---|---|---|
threads | Gmail | Một mảng gồm các chuỗi cần xoá nhãn. |
Cầu thủ trả bóng
Gmail
– Nhãn này dùng để liên kết.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây hoặc các phạm vi thích hợp từ REST API có liên quan:
-
https://mail.google.com/