Class GmailThread

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

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

פרמטרים

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• removeLabel(label)

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

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

פרמטרים

חזרה

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

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-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.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.createDraftReply('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: 'another@example.com',
});

פרמטרים

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

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

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

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

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

פרמטרים

חזרה

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

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-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.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.createDraftReplyAll('incapable of HTML', {
  htmlBody: '<b>some HTML body text</b>',
  cc: 'another@example.com',
});

פרמטרים

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

חזרה

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

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(firstThread.getFirstMessageSubject());

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• getLastMessageDate()

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

// Log the subject of the first message in the first thread in the inbox.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const id = firstThread.getId();
// Get same thread by its ID.
const 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const labels = firstThread.getLabels();
for (let i = 0; i < labels.length; i++) {
  Logger.log(labels[i].getName());
}

חזרה

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

אישור

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

• https://mail.google.com/

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

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

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• getFirstMessageSubject()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• getMessages()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• getMessageCount()

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

הערה: הפתרון הזה פועל רק בממשק הקלאסי של Gmail, ולא ב-Inbox.

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

חזרה

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

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

// Log if this thread has starred messages
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`has starred : ${firstThread.hasStarredMessages()}`);

חזרה

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

אישור

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

• https://mail.google.com/

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

// Log if this thread is marked as important
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Important? : ${firstThread.isImportant()}`);

חזרה

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

אישור

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

• https://mail.google.com/

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

// Log if this thread is a chat
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`is in chats? : ${firstThread.isInChats()}`);

חזרה

‫Boolean — true אם השרשור מסומן כצ'אט

אישור

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

• https://mail.google.com/

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

// Log if this thread is in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`is in the inbox? : ${firstThread.isInInbox()}`);

חזרה

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

אישור

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

• https://mail.google.com/

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

// Log if this thread is in the priority inbox
const firstThread = GmailApp.getPriorityInboxThreads(0, 1)[0];
Logger.log(`is in priority inbox? ${firstThread.isInPriorityInbox()}`);

חזרה

‫Boolean — true אם השרשור נמצא בדואר הממוין

אישור

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

• https://mail.google.com/

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

// Log if this thread is in the spam folder
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Spam? ${firstThread.isInSpam()}`);

חזרה

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

אישור

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

• https://mail.google.com/

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

// Log if this thread is in the trash
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Trashed? ${firstThread.isInTrash()}`);

חזרה

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

אישור

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

• https://mail.google.com/

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

// Log if this thread is unread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Unread? ${firstThread.isUnread()}`);

חזרה

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

אישור

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

• https://mail.google.com/

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

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

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• markUnimportant()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• markUnread()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• markImportant()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• markRead()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

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

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

חזרה

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

אישור

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

• https://mail.google.com/

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

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

חזרה

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

אישור

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

• https://mail.google.com/

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

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

חזרה

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

אישור

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

• https://mail.google.com/

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

const 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 – השרשור הזה, שימושי לשרשור

אישור

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

• https://mail.google.com/

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

const myLabel = GmailApp.getUserLabelByName('<your label>');
const threads = myLabel.getThreads();
for (const thread of threads) {
  thread.removeLabel(myLabel);
}

פרמטרים

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• addLabel(label)

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

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

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

פרמטרים

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

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

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

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

פרמטרים

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

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

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

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

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

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

פרמטרים

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

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

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

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

פרמטרים

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

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

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