Class GmailThread

Gmailשרשור

שיחה בחשבון Gmail של משתמש.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
addLabel(label)	GmailThread	הוספת התווית הזו לשרשור.
createDraftReply(body)	GmailDraft	יצירת טיוטת הודעה שתישלח למי ששלח את ההודעה האחרונה בשרשור הזה, באמצעות כתובת האימייל ל'מענה אל'.
createDraftReply(body, options)	GmailDraft	יצירת טיוטה של הודעה שתישלח בתשובה לשולח ההודעה האחרונה בשרשור הזה, באמצעות כתובת האימייל של השולח, עם ארגומנטים אופציונליים.
createDraftReplyAll(body)	GmailDraft	האפשרות הזו יוצרת טיוטה של הודעה שתישלח לשולח ההודעה האחרונה בשרשור הזה, באמצעות כתובת התשובה וכל הנמענים של ההודעה הזו.
createDraftReplyAll(body, options)	GmailDraft	יצירת טיוטת הודעה שתהיה תשובה לשולח ההודעה האחרונה בשרשור הזה, באמצעות כתובת התשובה וכל הנמענים, עם ארגומנטים אופציונליים.
getFirstMessageSubject()	String	הפונקציה מקבלת את הנושא של ההודעה הראשונה בשרשור.
getId()	String	הפונקציה מקבלת את המזהה של השרשור.
getLabels()	GmailLabel[]	הפונקציה מחזירה את התווית שנוצרה על ידי המשתמש בשרשור הזה.
getLastMessageDate()	Date	הפונקציה מקבלת את התאריך של ההודעה האחרונה בשרשור הזה.
getMessageCount()	Integer	הפונקציה מחזירה את מספר ההודעות בשרשור.
getMessages()	GmailMessage[]	הצגת ההודעות בשרשור הזה.
getPermalink()	String	הפונקציה מקבלת קישור קבוע לשרשור הזה.
hasStarredMessages()	Boolean	הפונקציה מחזירה תשובה אם יש בשרשור הודעות שמסומנות בכוכב.
isImportant()	Boolean	הפונקציה מחזירה את הערך true אם השרשור מסומן כחשוב, או את הערך false אם לא.
isInChats()	Boolean	הפונקציה מחזירה אם השרשור מסומן כצ'אט.
isInInbox()	Boolean	הפונקציה מחזירה את הערך true אם השרשור נמצא בתיבת הדואר הנכנס.
isInPriorityInbox()	Boolean	הפונקציה מחזירה את הערך true אם השרשור נמצא בתיבת הדואר הנכנס בעדיפות גבוהה, ואת הערך false במקרים אחרים.
isInSpam()	Boolean	הפונקציה מחזירה אם השרשור סומן כספאם.
isInTrash()	Boolean	הפונקציה מחזירה אם השרשור נמצא באשפה.
isUnread()	Boolean	הפונקציה מחזירה את הערך True אם יש בשרשור הודעות שלא נקראו.
markImportant()	GmailThread	סימון השרשור כחשוב.
markRead()	GmailThread	סימון השרשור כנקרא.
markUnimportant()	GmailThread	סימון השרשור כלא חשוב.
markUnread()	GmailThread	סימון השרשור כ'לא נקרא'.
moveToArchive()	GmailThread	העברת השרשור לארכיון.
moveToInbox()	GmailThread	העברת השרשור הזה לתיבת הדואר הנכנס.
moveToSpam()	GmailThread	העברת השרשור הזה לספאם.
moveToTrash()	GmailThread	העברת השרשור לאשפה.
refresh()	GmailThread	טעינת מחדש של השרשור הזה והמצב המשויך מ-Gmail (שימושי במקרה שהתוויות, מצב הקריאה וכו' השתנו).
removeLabel(label)	GmailThread	הסרת התווית מהשרשור.
reply(body)	GmailThread	משיבים לשולח ההודעה האחרונה בשרשור הזה באמצעות הכתובת replyTo.
reply(body, options)	GmailThread	משיבים לשולח ההודעה האחרונה בשרשור הזה באמצעות כתובת replyTo, עם ארגומנטים אופציונליים.
replyAll(body)	GmailThread	להשיב לשולח (באמצעות כתובת replyTo) לכל הנמענים של ההודעה האחרונה בשרשור הזה.
replyAll(body, options)	GmailThread	שליחת תשובה לשולח (באמצעות הכתובת replyTo) לכל הנמענים של ההודעה האחרונה בשרשור הזה, עם ארגומנטים אופציונליים.

מסמכים מפורטים

addLabel(label)

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

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

פרמטרים

שם	סוג	תיאור
label	GmailLabel	התווית שרוצים להחיל על השרשור

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• removeLabel(label)

---

createDraftReply(body)

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

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

פרמטרים

שם	סוג	תיאור
body	String	גוף האימייל

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

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

---

createDraftReply(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: '[e-mail]',
});

פרמטרים

שם	סוג	תיאור
body	String	גוף האימייל
options	Object	אובייקט JavaScript שמציין פרמטרים מתקדמים, כפי שמפורטים בהמשך

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

שם	סוג	תיאור
attachments	BlobSource[]	מערך של קבצים שרוצים לשלוח באימייל
bcc	String	רשימה של כתובות אימייל שמופרדות בפסיקים, לצורך שליחת עותק מוסתר
cc	String	רשימה מופרדת בפסיקים של כתובות אימייל לשליחת עותק
from	String	הכתובת שממנה צריך לשלוח את האימייל, והיא חייבת להיות אחד מהערכים שמוחזרים על ידי GmailApp.getAliases()
htmlBody	String	אם השדה מוגדר, מכשירים שיכולים להציג HTML ישתמשו בו במקום בארגומנט הנדרש body. אפשר להוסיף שדה inlineImages אופציונלי בגוף ה-HTML אם יש תמונות מוטמעות באימייל.
inlineImages	Object	אובייקט JavaScript שמכיל מיפוי ממפתח תמונה (String) לנתוני תמונה (BlobSource). ההנחה היא שמשתמשים בפרמטר htmlBody והוא מכיל הפניות לתמונות האלה בפורמט <img src="cid:imageKey" />
name	String	השם של השולח של האימייל (ברירת המחדל: שם המשתמש)
replyTo	String	כתובת אימייל שישמש ככתובת ברירת המחדל לתשובות (ברירת המחדל: כתובת האימייל של המשתמש)
subject	String	שורת נושא חדשה לאימייל (עד 250 תווים)

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

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

---

createDraftReplyAll(body)

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

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

פרמטרים

שם	סוג	תיאור
body	String	גוף האימייל

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(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: '[e-mail]',
});

פרמטרים

שם	סוג	תיאור
body	String	גוף האימייל
options	Object	אובייקט JavaScript שמציין פרמטרים מתקדמים, כפי שמפורטים בהמשך

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

שם	סוג	תיאור
attachments	BlobSource[]	מערך של קבצים שרוצים לשלוח באימייל
bcc	String	רשימה של כתובות אימייל שמופרדות בפסיקים, לצורך שליחת עותק מוסתר
cc	String	רשימה מופרדת בפסיקים של כתובות אימייל לשליחת עותק
from	String	הכתובת שממנה צריך לשלוח את האימייל, והיא חייבת להיות אחד מהערכים שמוחזרים על ידי GmailApp.getAliases()
htmlBody	String	אם השדה מוגדר, מכשירים שיכולים להציג HTML ישתמשו בו במקום בארגומנט הנדרש body. אפשר להוסיף שדה inlineImages אופציונלי בגוף ה-HTML אם יש תמונות מוטמעות באימייל.
inlineImages	Object	אובייקט JavaScript שמכיל מיפוי ממפתח תמונה (String) לנתוני תמונה (BlobSource). ההנחה היא שמשתמשים בפרמטר htmlBody והוא מכיל הפניות לתמונות האלה בפורמט <img src="cid:imageKey" />
name	String	השם של השולח של האימייל (ברירת המחדל: שם המשתמש)
replyTo	String	כתובת אימייל שישמש ככתובת ברירת המחדל לתשובות (ברירת המחדל: כתובת האימייל של המשתמש)
subject	String	שורת נושא חדשה לאימייל. הגודל המקסימלי הוא 250 תווים.

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

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

---

getFirstMessageSubject()

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

// 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 – הנושא של ההודעה הראשונה בשרשור

אישור

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

• https://mail.google.com/

ראה גם

• getLastMessageDate()

---

getId()

הפונקציה מקבלת את המזהה של השרשור. המזהה של שרשור משתנה בהתאם להודעות שהוא מכיל. כדי לקבל מזהה עקבי של הודעה מסוימת בשרשור, צריך להפעיל את הפונקציה 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 – המזהה של השרשור הזה

---

getLabels()

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

// 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[] – מערך של תוויות לשרשור הזה

אישור

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

• https://mail.google.com/

---

getLastMessageDate()

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

// 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 — התאריך של ההודעה האחרונה בשרשור

אישור

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

• https://mail.google.com/

ראה גם

• getFirstMessageSubject()

---

getMessageCount()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• getMessages()

---

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 בשרשור הזה

אישור

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

• https://mail.google.com/

ראה גם

• getMessageCount()

---

getPermalink()

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

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

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

חזרה

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

---

hasStarredMessages()

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

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

חזרה

Boolean — הערך True מוחזר אם יש בשרשור הודעות שסומנו בכוכב

אישור

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

• https://mail.google.com/

---

isImportant()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

---

isInChats()

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

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

חזרה

Boolean — הערך True אם השרשור מסומן כצ'אט

אישור

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

• https://mail.google.com/

---

isInInbox()

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

// 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 אם השרשור נמצא בתיבת הדואר הנכנס

אישור

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

• https://mail.google.com/

---

isInPriorityInbox()

הפונקציה מחזירה את הערך 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 אם השרשור נמצא בתיבת הדואר הנכנס ברשימת 'חשוב'

אישור

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

• https://mail.google.com/

---

isInSpam()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

---

isInTrash()

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

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

חזרה

Boolean — הערך True אם השרשור נמצא באשפה

אישור

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

• https://mail.google.com/

---

isUnread()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

---

markImportant()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• markUnimportant()

---

markRead()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• markUnread()

---

markUnimportant()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• markImportant()

---

markUnread()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• markRead()

---

moveToArchive()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

---

moveToInbox()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

---

moveToSpam()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

---

moveToTrash()

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

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

חזרה

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

אישור

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

• https://mail.google.com/

---

refresh()

טעינת מחדש של השרשור הזה והמצב המשויך מ-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 — השרשור הזה, שימושי לשרשור

אישור

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

• https://mail.google.com/

---

removeLabel(label)

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

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

פרמטרים

שם	סוג	תיאור
label	GmailLabel	התווית שרוצים להסיר מהשרשור

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

• addLabel(label)

---

reply(body)

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

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

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

פרמטרים

שם	סוג	תיאור
body	String	גוף האימייל

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

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

---

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

פרמטרים

שם	סוג	תיאור
body	String	גוף האימייל
options	Object	אובייקט JavaScript שמציין פרמטרים מתקדמים, כפי שמפורטים בהמשך

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

שם	סוג	תיאור
cc	String	רשימה של כתובות אימייל לשליחת עותק, מופרדות בפסיקים
bcc	String	רשימה של כתובות אימייל שמופרדות בפסיקים, לצורך הוספה בשדה 'עותק מוסתר'
htmlBody	String	אם השדה מוגדר, מכשירים שיכולים להציג HTML ישתמשו בו במקום בארגומנט הנדרש body. אפשר להוסיף שדה inlineImages אופציונלי בגוף ה-HTML אם יש תמונות מוטמעות באימייל.
name	String	השם של השולח של האימייל (ברירת המחדל: שם המשתמש)
from	String	הכתובת שממנה צריך לשלוח את האימייל, והיא חייבת להיות אחד מהערכים שמוחזרים על ידי GmailApp.getAliases()
replyTo	String	כתובת אימייל שישמש ככתובת ברירת המחדל לתשובות (ברירת המחדל: כתובת האימייל של המשתמש)
noReply	Boolean	true אם האימייל צריך להישלח מכתובת אימייל גנרית ללא מענה כדי למנוע מהנמענים להשיב לאימיילים. האפשרות הזו זמינה רק לחשבונות Google Workspace, ולא למשתמשי Gmail.
attachments	BlobSource[]	מערך של קבצים שרוצים לשלוח באימייל
inlineImages	Object	אובייקט JavaScript שמכיל מיפוי ממפתח תמונה (String) לנתוני תמונה (BlobSource). ההנחה היא שמשתמשים בפרמטר htmlBody והוא מכיל הפניות לתמונות האלה בפורמט <img src="cid:imageKey" />

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

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

---

replyAll(body)

להשיב לשולח (באמצעות כתובת 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');

פרמטרים

שם	סוג	תיאור
body	String	גוף האימייל

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

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

---

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,
});

פרמטרים

שם	סוג	תיאור
body	String	גוף האימייל
options	Object	אובייקט JavaScript שמציין פרמטרים מתקדמים, כפי שמפורטים בהמשך

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

שם	סוג	תיאור
cc	String	רשימה של כתובות אימייל לשליחת עותק, מופרדות בפסיקים
bcc	String	רשימה של כתובות אימייל שמופרדות בפסיקים, לצורך הוספה בשדה 'עותק מוסתר'
htmlBody	String	אם השדה מוגדר, מכשירים שיכולים להציג HTML ישתמשו בו במקום בארגומנט הנדרש body. אפשר להוסיף שדה inlineImages אופציונלי בגוף ה-HTML אם יש תמונות מוטמעות באימייל.
name	String	השם של השולח של האימייל (ברירת המחדל: שם המשתמש)
from	String	הכתובת שממנה צריך לשלוח את האימייל, והיא חייבת להיות אחד מהערכים שמוחזרים על ידי GmailApp.getAliases()
replyTo	String	כתובת אימייל שישמש ככתובת ברירת המחדל לתשובות (ברירת המחדל: כתובת האימייל של המשתמש)
noReply	Boolean	true אם האימייל צריך להישלח מכתובת אימייל גנרית ללא מענה כדי למנוע מהנמענים להשיב לאימיילים. האפשרות הזו אפשרית רק לחשבונות G Suite, ולא למשתמשים ב-Gmail.
attachments	BlobSource[]	מערך של קבצים שרוצים לשלוח באימייל
inlineImages	Object	אובייקט JavaScript שמכיל מיפוי ממפתח תמונה (String) לנתוני תמונה (BlobSource). ההנחה היא שמשתמשים בפרמטר htmlBody והוא מכיל הפניות לתמונות האלה בפורמט <img src="cid:imageKey" />

חזרה

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

אישור

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

• https://mail.google.com/

ראה גם

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