Class GmailThread

התווית תתווסף לשרשור.

// Add label MyLabel to the first thread in the inbox
var label = GmailApp.getUserLabelByName("MyLabel");
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.addLabel(label);

פרמטרים

חזרה

GmailThread – השרשור הזה, שימושי לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• removeLabel(label)

יצירת טיוטה של הודעת תשובה לשולח ההודעה האחרונה בשרשור באמצעות כתובת לתשובה. גודל האימייל (כולל הכותרות) מוגבל במכסה.

// Create a draft reply to the message author with an acknowledgement.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.createDraftReply("Got your message");

פרמטרים

חזרה

GmailDraft – טיוטת ההודעה החדשה שנוצרה

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• reply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

יצירת טיוטה של הודעת תשובה לשולח ההודעה האחרונה בשרשור באמצעות כתובת לתשובה, עם ארגומנטים אופציונליים.

האימייל יכול להכיל גם טקסט פשוט וגם גוף HTML. גודל האימייל (כולל כותרות) הוא מכסה מוגבלת.

// Create a draft response with an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.createDraftReply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

פרמטרים

פרמטרים מתקדמים

חזרה

GmailDraft – טיוטת ההודעה החדשה שנוצרה

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• reply(body, options)
• createDraftReply(body)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

יצירת טיוטה של הודעה שמשיבה לשולח ההודעה האחרונה בשרשור באמצעות כתובת לתשובה ולכל הנמענים של הודעה זו. גודל הודעת האימייל (כולל כותרות) המכסה מוגבלת.

// Create a draft reply to all recipients (except those bcc'd) of the last email in this
// thread.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("Got your message");

פרמטרים

חזרה

GmailDraft – טיוטת ההודעה החדשה שנוצרה

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body, options)

יצירת טיוטה של הודעה שמשיבה לשולח ההודעה האחרונה בשרשור באמצעות כתובת לתשובה וכל הנמענים, עם ארגומנטים אופציונליים.

האימייל יכול להכיל גם טקסט פשוט וגם גוף HTML. גודל האימייל (כולל כותרות) הוא מכסה מוגבלת.

// Create a draft reply, using an HTML text body, to all recipients (except those bcc'd) of
// the last email of in this thread.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.createDraftReplyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

פרמטרים

פרמטרים מתקדמים

חזרה

GmailDraft – טיוטת ההודעה החדשה שנוצרה

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• replyAll(body, options)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)

קבלת הנושא של ההודעה הראשונה בשרשור.

// Log the subject of the first message in the first thread in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log(firstThread.getFirstMessageSubject());

חזרה

String – הנושא של ההודעה הראשונה בשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• getLastMessageDate()

קבלת מזהה השרשור הזה. המזהה של שרשור משתנה בהתאם להודעות שהוא מכיל. עבור מזהה עקבי של הודעה מסוימת בשרשור, קוראים לפונקציה getMessages()[0].getId() במקום זאת.

// Log the subject of the first message in the first thread in the inbox.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var id = firstThread.getId();
// Get same thread by its ID.
var thread = GmailApp.getThreadById(id);
Logger.log(thread.getFirstMessageSubject() == firstThread.getFirstMessageSubject()); // True

חזרה

String – מזהה השרשור הזה

מחזירה את התוויות שנוצרו על ידי המשתמש בשרשור זה.

// Log the names of the labels attached to the first thread in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var labels = firstThread.getLabels();
for (var i = 0; i < labels.length; i++) {
  Logger.log(labels[i].getName());
}

חזרה

GmailLabel[] – מערך תוויות לשרשור הזה

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

הפונקציה מקבלת את התאריך של ההודעה האחרונה בשרשור.

// Log the date of the most recent message on the first thread in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log(firstThread.getLastMessageDate());

חזרה

Date – התאריך של ההודעה האחרונה בשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• getFirstMessageSubject()

הפונקציה מחזירה את מספר ההודעות בשרשור.

// Log the number of messages in the thread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log(firstThread.getMessageCount());

חזרה

Integer – מספר ההודעות בשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• getMessages()

קבלת ההודעות בשרשור הזה.

// Log the subjects of the messages in the thread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var messages = firstThread.getMessages();
for (var i = 0; i < messages.length; i++) {
  Logger.log(messages[i].getSubject());
}

חזרה

GmailMessage[] – מערך הודעות Gmail בשרשור הזה

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• getMessageCount()

מתקבל קישור קבוע לשרשור הזה.

לתשומת ליבכם: האפשרות הזו פועלת רק בממשק הקלאסי של Gmail, ולא בממשק של תיבת הדואר הנכנס.

// Logs the permalink for the first thread in the inbox
var thread = GmailApp.getInboxThreads(0,1)[0];
Logger.log(thread.getPermalink());

חזרה

String – הקישור הקבוע לשרשור הזה

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

// Log if this thread has starred messages
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('has starred : ' + firstThread.hasStarredMessages());

חזרה

Boolean — true אם יש בשרשור הודעות שמסומנות בכוכב

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

הפונקציה מחזירה אם השרשור מסומן כחשוב.

// Log if this thread is marked as important
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Important? : ' + firstThread.isImportant());

חזרה

Boolean – האם השרשור מסומן כחשוב.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

הפונקציה מחזירה אם השרשור מסומן בתווית צ'אט.

// Log if this thread is a chat
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('is in chats? : ' + firstThread.isInChats());

חזרה

Boolean – True אם השרשור מסומן בתווית של צ'אט

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

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

// Log if this thread is in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('is in the inbox? : ' + firstThread.isInInbox());

חזרה

Boolean — True אם השרשור נמצא בתיבת הדואר הנכנס

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

הפונקציה מחזירה true אם השרשור הזה נמצא בתיבת הדואר הנכנס בעדיפות גבוהה; מחזירה את הערך false.

// Log if this thread is in the priority inbox
var firstThread = GmailApp.getPriorityInboxThreads(0,1)[0];
Logger.log("is in priority inbox? " + firstThread.isInPriorityInbox());

חזרה

Boolean – True אם השרשור נמצא בתיבת הדואר הנכנס בעדיפות גבוהה

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

הפונקציה מחזירה אם השרשור מסומן כספאם.

// Log if this thread is in the spam folder
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Spam? ' + firstThread.isInSpam());

חזרה

Boolean – האם השרשור הזה סומן כספאם.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

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

// Log if this thread is in the trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Trashed? ' + firstThread.isInTrash());

חזרה

Boolean – True אם השרשור נמצא באשפה

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

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

// Log if this thread is unread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Unread? ' + firstThread.isUnread());

חזרה

Boolean — true אם יש הודעות שלא נקראו

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

סימון השרשור הזה כחשוב.

// Mark first inbox thread as important
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.markImportant();

חזרה

GmailThread – השרשור הזה, שימושי לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• markUnimportant()

השרשור הזה יסומן כ'נקרא'.

// Mark first inbox thread as read
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.markRead();

חזרה

GmailThread – השרשור הזה, שימושי לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• markUnread()

סימון השרשור הזה כלא חשוב.

// Mark first inbox thread as unimportant
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.markUnimportant();

חזרה

GmailThread – השרשור הזה, שימושי לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• markImportant()

השרשור הזה יסומן כ'עוד לא קראתי'.

// Mark first inbox thread as unread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.markUnread();

חזרה

GmailThread – השרשור הזה, שימושי לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• markRead()

העברת השרשור לארכיון.

// Archive first inbox thread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.moveToArchive();

חזרה

GmailThread – השרשור הזה, שימושי לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

העברת השרשור הזה לתיבת הדואר הנכנס.

// Move first non-inbox thread to inbox
var firstThread = GmailApp.search("-in:inbox")[0];
firstThread.moveToInbox();

חזרה

GmailThread – השרשור הזה, שימושי לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

השרשור הזה יועבר לספאם.

// Move first inbox thread to spam
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.moveToSpam();

חזרה

GmailThread – השרשור הזה, שימושי לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

השרשור מועבר לאשפה.

// Move first inbox thread to trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.moveToTrash();

חזרה

GmailThread – השרשור הזה, שימושי לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

טוען מחדש את השרשור הזה, ואת המצב המשויך אליו מ-Gmail (שימושי במקרה של התוויות, מצב הקריאה, וכו').

var firstThread = GmailApp.getInboxThreads(0,1)[0];
// ...Do something that may take a while here....
firstThread.refresh(); // Make sure it's up-to-date
// ...Do more stuff with firstThread ...

חזרה

GmailThread – השרשור הזה, שימושי לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

הסרת התווית הזו מהשרשור.

var myLabel = GmailApp.getUserLabelByName('<your label>');
var threads = myLabel.getThreads();
for (var x in threads) {
  var thread = threads[x];
  thread.removeLabel(myLabel);
}

פרמטרים

חזרה

GmailThread – השרשור הזה, שימושי לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• addLabel(label)

שליחת תשובה לשולח ההודעה האחרונה בשרשור הזה באמצעות הכתובת לתשובה.

חשוב לשים לב שהגודל הכולל של הודעת האימייל (כולל כל הכותרות) לא יכול לחרוג מ-20KB.

// Respond to author of last email in thread with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.reply("Got your message");

פרמטרים

חזרה

GmailThread – השרשור הזה, שימושי לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• reply(body, options)
• replyAll(body)
• replyAll(body, options)

שליחת תשובה לשולח ההודעה האחרונה בשרשור הזה באמצעות הכתובת לתשובה ארגומנטים. האימייל יכול להכיל גם טקסט פשוט וגם גוף HTML. שימו לב שהמחיר הכולל גודל הודעת האימייל (כולל כל הכותרות, אבל לא כולל קבצים מצורפים) לא יעלה על 20KB.

// Respond with HTML body text.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.reply("incapable of HTML", {
  htmlBody: "some HTML body text",
  noReply: true
});

פרמטרים

פרמטרים מתקדמים

חזרה

GmailThread – השרשור הזה, שימושי לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• reply(body)
• replyAll(body)
• replyAll(body, options)

להשיב לשולח (באמצעות הכתובת לתשובה) ולכל הנמענים בהודעה האחרונה בנושא של שרשור.

חשוב לשים לב שהגודל הכולל של הודעת האימייל (כולל כל הכותרות) לא יכול לחרוג מ-20KB.

// Respond to all with acknowledgment to the first thread in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.replyAll("Got your message");

פרמטרים

חזרה

GmailThread – השרשור הזה, שימושי לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• reply(body, options)
• reply(body)
• replyAll(body, options)

להשיב לשולח (באמצעות הכתובת replyTo) ולכל הנמענים בהודעה האחרונה בשרשור הזה, עם ארגומנטים אופציונליים. האימייל יכול להכיל גם טקסט פשוט וגם גוף HTML. חשוב לשים לב שהגודל הכולל של הודעת האימייל (כולל כל הכותרות, אבל לא כולל קבצים מצורפים) עד 20KB.

// Respond with HTML body text.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.replyAll("incapable of HTML", {
  htmlBody: "some HTML body text",
  noReply: true
});

פרמטרים

פרמטרים מתקדמים

חזרה

GmailThread – השרשור הזה, שימושי לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מההיקפים הבאים או עם היקפי הרשאות מתאימים מ-ה-API הרלוונטי ל-REST:

• https://mail.google.com/

ראה גם

• reply(body)
• replyAll(body)
• replyAll(body, options)