Class GmailLabel

เพิ่มป้ายกำกับนี้ลงในชุดข้อความที่ระบุและบังคับให้ชุดข้อความรีเฟรช (GmailThread.refresh())

// 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);

พารามิเตอร์

รีเทิร์น

GmailLabel \- ป้ายกำกับนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์ที่มี ขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขตหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

• https://mail.google.com/

ดูเพิ่มเติม

• removeFromThread(thread)

เพิ่มป้ายกำกับนี้ลงในชุดข้อความที่ระบุและบังคับให้ชุดข้อความรีเฟรช คุณเพิ่มป้ายกำกับสำหรับชุดข้อความได้สูงสุด 100 ชุดต่อชุด

// 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);

พารามิเตอร์

รีเทิร์น

GmailLabel \- ป้ายกำกับนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์ที่มี ขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขตหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

• https://mail.google.com/

ดูเพิ่มเติม

• removeFromThreads(threads)

ลบป้ายกำกับนี้

const label = GmailApp.getUserLabelByName('MyLabel');
label.deleteLabel();

ส่ง

Error \- หากลบป้ายกำกับไม่ได้

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์ที่มี ขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขตหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

• https://mail.google.com/

ดูเพิ่มเติม

• getName()

รับรหัสของป้ายกำกับนี้

const label = GmailApp.getUserLabelByName('MyLabel');
console.log(label.getId());

รีเทิร์น

String \- รหัสของป้ายกำกับ

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์ที่มี ขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขตหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

• https://mail.google.com/

รับชื่อของป้ายกำกับนี้

const label = GmailApp.getUserLabelByName('MyLabel');
Logger.log(label.getName());  // logs MyLabel

รีเทิร์น

String \- ชื่อของป้ายกำกับ

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์ที่มี ขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขตหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

• https://mail.google.com/

รับชุดข้อความที่มีป้ายกำกับนี้

การเรียกนี้จะล้มเหลวเมื่อขนาดของเทรดทั้งหมดใหญ่เกินกว่าที่ระบบจะจัดการได้ ในกรณีที่ไม่ทราบขนาดของชุดข้อความและอาจมีขนาดใหญ่มาก โปรดใช้ getThreads(start, max) และระบุช่วงของชุดข้อความที่จะดึงข้อมูลในการเรียกแต่ละครั้ง

// 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());
}

รีเทิร์น

GmailThread[] \- อาร์เรย์ของชุดข้อความที่มีป้ายกำกับนี้

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์ที่มี ขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขตหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

• https://mail.google.com/

รับชุดข้อความช่วงหนึ่งที่มีป้ายกำกับนี้

// 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());
}

พารามิเตอร์

รีเทิร์น

GmailThread[] \- อาร์เรย์ของชุดข้อความที่มีป้ายกำกับนี้

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์ที่มี ขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขตหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

• https://mail.google.com/

รับจำนวนชุดข้อความที่ยังไม่อ่านซึ่งติดป้ายกำกับนี้

// log the number of unread threads labeled with MyLabel
const label = GmailApp.getUserLabelByName('MyLabel');
Logger.log(label.getUnreadCount());

รีเทิร์น

Integer \- จำนวนชุดข้อความที่ติดป้ายกำกับและยังไม่อ่าน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์ที่มี ขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขตหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

• https://mail.google.com/

นำป้ายกำกับนี้ออกจากชุดข้อความที่ระบุและบังคับให้ชุดข้อความรีเฟรช

// 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);

พารามิเตอร์

รีเทิร์น

GmailLabel \- ป้ายกำกับนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์ที่มี ขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขตหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

• https://mail.google.com/

ดูเพิ่มเติม

• addToThread(thread)

นำป้ายกำกับนี้ออกจากชุดข้อความที่ระบุและบังคับให้ชุดข้อความรีเฟรช คุณนำป้ายกำกับออกจากชุดข้อความได้สูงสุด 100 ชุดต่อชุด

// 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);

พารามิเตอร์

รีเทิร์น

GmailLabel \- ป้ายกำกับนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์ที่มี ขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขตหรือขอบเขตที่เหมาะสมจาก REST API ที่เกี่ยวข้อง

• https://mail.google.com/

ดูเพิ่มเติม

• addToThreads(threads)