Class GmailDraft

Gmailטיוטה

טיוטת הודעה שנוצרה על ידי משתמש בחשבון Gmail שלו.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
deleteDraft()	void	מחיקת הטיוטה של ההודעה.
getId()	String	הפונקציה מקבלת את המזהה של טיוטת ההודעה הזו.
getMessage()	GmailMessage	הפונקציה מחזירה GmailMessage שמייצג את הטיוטה הזו.
getMessageId()	String	הפונקציה מחזירה את המזהה של GmailMessage שמייצג את הטיוטה הזו.
send()	GmailMessage	שליחת טיוטת האימייל.
update(recipient, subject, body)	GmailDraft	הפעולה הזו תחליף את התוכן של טיוטת ההודעה הזו.
update(recipient, subject, body, options)	GmailDraft	מחליפה את התוכן של טיוטת ההודעה הזו באמצעות ארגומנטים אופציונליים.

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

deleteDraft()

מחיקת הטיוטה של ההודעה.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
draft.deleteDraft();
draft.getMessage();  // Throws exception.

אישור

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

• https://mail.google.com/

---

getId()

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

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const draftId = draft.getId();
const draftById = GmailApp.getDraft(draftId);
Logger.log(
    draft.getMessage().getSubject() === draftById.getMessage().getSubject(),
);

חזרה

String – מזהה הטיוטה

אישור

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

• https://mail.google.com/

---

getMessage()

הפונקציה מחזירה GmailMessage שמייצג את הטיוטה הזו.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const message = draft.getMessage();
Logger.log(message.getSubject());

חזרה

GmailMessage – ההודעה שמייצגת את תוכן הטיוטה הזו

אישור

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

• https://mail.google.com/

---

getMessageId()

הפונקציה מחזירה את המזהה של GmailMessage שמייצג את הטיוטה הזו.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const messageId = draft.getMessageId();
Logger.log(messageId === draft.getMessage().getId());

חזרה

String – מזהה ההודעה

אישור

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

• https://mail.google.com/

---

send()

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

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const msg = draft.send();     // Send it
Logger.log(msg.getDate());    // Should be approximately the current timestamp

חזרה

GmailMessage – ההודעה שנשלחה לאחרונה

אישור

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

• https://mail.google.com/

---

update(recipient, subject, body)

הפעולה הזו תחליף את התוכן של טיוטת ההודעה הזו. גודל האימייל (כולל כותרות) מוגבל במכסה.

// The code below will update a draft email with the current date and time.
const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const now = new Date();
draft.update(
    '[e-mail]',
    'current time',
    `The time is: ${now.toString()}`,
);

פרמטרים

שם	סוג	תיאור
recipient	String	רשימה של כתובות אימייל מופרדות בפסיקים
subject	String	נושא האימייל (עד 250 תווים)
body	String	גוף האימייל

חזרה

GmailDraft – הטיוטה העדכנית

אישור

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

• https://mail.google.com/

ראה גם

• GmailApp.createDraft(recipient, subject, body)

---

update(recipient, subject, body, options)

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

// Update a draft email with a file from Google Drive attached as a PDF.
const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
draft.update(
    '[e-mail]',
    'Attachment example',
    'Please see attached file.',
    {
      attachments: [file.getAs(MimeType.PDF)],
      name: 'Automatic Emailer Script',
    },
);

פרמטרים

שם	סוג	תיאור
recipient	String	רשימה של כתובות אימייל מופרדות בפסיקים
subject	String	נושא האימייל (עד 250 תווים)
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	כתובת אימייל שישמש ככתובת ברירת המחדל לתשובות (ברירת המחדל: כתובת האימייל של המשתמש)

חזרה

GmailDraft – הטיוטה העדכנית

אישור

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

• https://mail.google.com/

ראה גם

• GmailApp.createDraft(recipient, subject, body, options)