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 — התווית הזו, לשרשור.

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

• 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 — התווית הזו, לשרשור.

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

• https://mail.google.com/

ראה גם

• removeFromThreads(threads)

מחיקת התווית הזו.

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

מקפיצה את הודעות השגיאה (Throws)

‫Error – אם אי אפשר למחוק את התווית

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

• https://mail.google.com/

ראה גם

• getName()

מחזירה את המזהה של התווית.

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

חזרה

‫String — המזהה של התווית.

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

• https://mail.google.com/

מחזירה את השם של התווית.

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

חזרה

‫String – שם התווית.

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

• https://mail.google.com/

מחזירה את השרשורים שסומנו בתווית הזו.

השיחות האלה נכשלות כשהגודל של כל ה-threads גדול מדי בשביל שהמערכת תוכל לטפל בהם. אם גודל השרשור לא ידוע, ויכול להיות שהוא גדול מאוד, צריך להשתמש ב-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[] — מערך של שרשורים שסומנו בתווית הזו.

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

• 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[] — מערך של שרשורים שסומנו בתווית הזו.

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

• https://mail.google.com/

הפונקציה מחזירה את מספר השרשורים שלא נקראו שתויגו בתווית הזו.

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

חזרה

Integer — מספר השרשורים עם התווית שלא נקראו.

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

• 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 — התווית הזו, לשרשור.

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

• 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 — התווית הזו, לשרשור.

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

• https://mail.google.com/

ראה גם

• addToThreads(threads)