Class GmailLabel

GmailLabel

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ứcKiểu dữ liệu trả vềMô tả ngắn
addToThread(thread)GmailLabelThêm nhãn này vào luồng đã cho và buộc luồng làm mới (GmailThread.refresh()).
addToThreads(threads)GmailLabelThêm nhãn này vào các luồng đã cho và buộc các luồng làm mới.
deleteLabel()voidXoá nhãn này.
getName()StringLấy 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[]Nhận một loạt chuỗi chuỗi được đánh dấu bằng nhãn này.
getUnreadCount()IntegerLấy số chuỗi tin nhắn chưa đọc được gắn nhãn này.
removeFromThread(thread)GmailLabelXoá nhãn này khỏi luồng đã cho và buộc luồng làm mới.
removeFromThreads(threads)GmailLabelXoá nhãn này khỏi các luồng đã cho và buộc các luồng 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);

Các tham số

TênLoạiNội dung mô tả
threadGmailThreadChuỗi 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

Các tập lệnh sử dụng phương thức này cần được 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 từ API REST có 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 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);

Các tham số

TênLoạiNội dung mô tả
threadsGmailThread[]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

Các tập lệnh sử dụng phương thức này cần được 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 từ API REST có 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

Các tập lệnh sử dụng phương thức này cần được 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 từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm

getName()

Lấy 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

Các tập lệnh sử dụng phương thức này cần được 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 từ API REST có 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ành công khi kích thước của tất cả các luồng quá lớn để hệ thống có thể xử lý. Nếu kích thước luồng 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 luồng để 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 chuỗi đượ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

getThreads(start, max)

Nhận một loạt chuỗi 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());
}

Các tham số

TênLoạiNội dung mô tả
startIntegerChỉ mục của luồng bắt đầu.
maxIntegerSố lượng luồng tối đa cần trả về.

Cầu thủ trả bóng

GmailThread[] – Một mảng chuỗi đượ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 với một hoặc nhiều phạm vi hoặc phạm vi thích hợp sau đây từ API REST có liên quan:

  • https://mail.google.com/

getUnreadCount()

Lấy số 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 thư được gắn nhãn chưa đọc.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được 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 từ API REST có liên quan:

  • https://mail.google.com/

removeFromThread(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
var label = GmailApp.getUserLabelByName("MyLabel");
var firstThread = GmailApp.getInboxThreads(0,1)[0];
label.removeFromThread(firstThread);

Các tham số

TênLoạiNội dung mô tả
threadGmailThreadChuỗi 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

Các tập lệnh sử dụng phương thức này cần được 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 từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm

removeFromThreads(threads)

Xoá nhãn này khỏi các luồng đã cho và buộc các luồng làm mới. Bạn có thể xoá nhãn cho tối đa 100 luồng 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);

Các tham số

TênLoạiNội dung mô tả
threadsGmailThread[]Một loạt chuỗi cần không gắn nhãn.

Cầu thủ trả bóng

GmailLabel – Nhãn này để tạo chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được 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 từ API REST có liên quan:

  • https://mail.google.com/

Xem thêm