Class MailApp

MailApp

שליחת אימייל.

השירות הזה מאפשר למשתמשים לשלוח אימיילים עם שליטה מלאה בתוכן האימייל. בניגוד ל-GmailApp, המטרה היחידה של MailApp היא שליחת אימייל. ל-MailApp אין גישה לתיבת הדואר הנכנס ב-Gmail של המשתמש.

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

Methods

שיטהסוג הערך שמוחזרתיאור קצר
getRemainingDailyQuota()Integerהפונקציה מחזירה את מספר הנמענים שאפשר לשלוח להם אימיילים עד סוף היום.
sendEmail(message)voidשליחת אימייל.
sendEmail(recipient, subject, body)voidשליחת אימייל.
sendEmail(recipient, subject, body, options)voidשולח הודעת אימייל עם ארגומנטים אופציונליים.
sendEmail(to, replyTo, subject, body)voidשליחת אימייל.

תיעוד מפורט

getRemainingDailyQuota()

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

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

const emailQuotaRemaining = MailApp.getRemainingDailyQuota();
Logger.log(`Remaining email quota: ${emailQuotaRemaining}`);

חזרה

‫Integer — מספר האימיילים שנותרו שהסקריפט יכול לשלוח.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/script.send_mail

sendEmail(message)

שליחת אימייל. הגרסה הזו של השיטה גמישה הרבה יותר, ומאפשרת הרבה יותר אפשרויות. 

// This code fetches the Google and YouTube logos, inlines them in an email
// and sends the email
function inlineImage() {
  const googleLogoUrl =
      'https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png';
  const youtubeLogoUrl =
      'https://developers.google.com/youtube/images/YouTube_logo_standard_white.png';
  const googleLogoBlob =
      UrlFetchApp.fetch(googleLogoUrl).getBlob().setName('googleLogoBlob');
  const youtubeLogoBlob =
      UrlFetchApp.fetch(youtubeLogoUrl).getBlob().setName('youtubeLogoBlob');
  MailApp.sendEmail({
    to: 'recipient@example.com',
    subject: 'Logos',
    htmlBody: 'inline Google Logo<img src=\'cid:googleLogo\'> images! <br>' +
        'inline YouTube Logo <img src=\'cid:youtubeLogo\'>',
    inlineImages: {
      googleLogo: googleLogoBlob,
      youtubeLogo: youtubeLogoBlob,
    },
  });
}

פרמטרים

שםסוגתיאור
messageObjectאובייקט JavaScript שמייצג הודעת אימייל

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

שםסוגתיאור
attachmentsBlobSource[]מערך של קבצים לשליחה עם האימייל
bccStringרשימה של כתובות אימייל שמופרדות בפסיקים, להוספה לעותק מוסתר
bodyStringתוכן האימייל
ccStringרשימה של כתובות אימייל שמופרדות בפסיקים לשליחת עותק
htmlBodyStringאם מוגדר, מכשירים שיכולים להציג HTML ישתמשו בו במקום בארגומנט body הנדרש. אפשר להוסיף שדה inlineImages אופציונלי בגוף ה-HTML אם יש לכם תמונות מוטמעות באימייל
inlineImagesObjectאובייקט JavaScript שמכיל מיפוי ממפתח תמונה (String) לנתוני תמונה (BlobSource). ההנחה היא שהפרמטר htmlBody נמצא בשימוש ומכיל הפניות לתמונות האלה בפורמט <img src="cid:imageKey" /> (ראו דוגמה)
nameStringהשם של שולח האימייל. ברירת המחדל היא שם המשתמש של השולח.
noReplyBooleantrue אם האימייל צריך להישלח מכתובת אימייל כללית מסוג no-reply כדי למנוע מהנמענים להשיב לאימיילים. האפשרות הזו זמינה רק לחשבונות Google Workspace, ולא למשתמשי Gmail.
replyToStringכתובת אימייל שתשמש ככתובת ברירת המחדל לתשובה (ברירת מחדל: כתובת האימייל של המשתמש). אם המדיניות noReply מוגדרת לערך true, המערכת מתעלמת מהמדיניות replyTo.
subjectStringנושא האימייל
toStringכתובת האימייל של הנמען או רשימה של כתובות אימייל שמופרדות בפסיקים של הנמענים

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/script.send_mail

ראה גם

sendEmail(recipient, subject, body)

שליחת אימייל. 

MailApp.sendEmail(
    'recipient@example.com',
    'TPS reports',
    'Where are the TPS reports?',
);

פרמטרים

שםסוגתיאור
recipientStringהכתובות של הנמענים, מופרדות בפסיקים
subjectStringשורת הנושא
bodyStringתוכן האימייל

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/script.send_mail

sendEmail(recipient, subject, body, options)

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

// Send an email with two attachments: a file from Google Drive (as a PDF) and
// an HTML file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const blob = Utilities.newBlob(
    'Insert any HTML content here',
    'text/html',
    'my_document.html',
);
MailApp.sendEmail(
    'mike@example.com',
    'Attachment example',
    'Two files are attached.',
    {
      name: 'Automatic Emailer Script',
      attachments: [file.getAs(MimeType.PDF), blob],
    },
);

פרמטרים

שםסוגתיאור
recipientStringהכתובות של הנמענים, מופרדות בפסיקים
subjectStringשורת הנושא
bodyStringתוכן האימייל
optionsObjectאובייקט JavaScript שמציין פרמטרים מתקדמים, כמו אלה שמופיעים בהמשך

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

שםסוגתיאור
attachmentsBlobSource[]מערך של קבצים לשליחה עם האימייל (ראו דוגמה)
bccStringרשימה של כתובות אימייל שמופרדות בפסיקים, להוספה לעותק מוסתר
ccStringרשימה של כתובות אימייל שמופרדות בפסיקים לשליחת עותק
htmlBodyStringאם מוגדר, מכשירים שיכולים להציג HTML ישתמשו בו במקום בארגומנט body הנדרש. אפשר להוסיף שדה inlineImages אופציונלי בגוף ה-HTML אם יש לכם תמונות מוטמעות באימייל
inlineImagesObjectאובייקט JavaScript שמכיל מיפוי ממפתח התמונה (String) לנתוני התמונה (BlobSource). ההנחה היא שהפרמטר htmlBody נמצא בשימוש ומכיל הפניות לתמונות האלה בפורמט <img src="cid:imageKey" />
nameStringהשם של שולח האימייל (ברירת מחדל: השם של המשתמש)
noReplyBooleantrue אם האימייל צריך להישלח מכתובת אימייל כללית מסוג no-reply כדי למנוע מהנמענים להשיב לאימיילים. האפשרות הזו זמינה רק לחשבונות Google Workspace, ולא למשתמשי Gmail.
replyToStringכתובת אימייל שתשמש ככתובת ברירת המחדל לתשובה (ברירת מחדל: כתובת האימייל של המשתמש)

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/script.send_mail

ראה גם

sendEmail(to, replyTo, subject, body)

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

MailApp.sendEmail(
    'recipient@example.com',
    'replies@example.com',
    'TPS report status',
    'What is the status of those TPS reports?',
);

פרמטרים

שםסוגתיאור
toStringהכתובות של הנמענים, מופרדות בפסיקים
replyToStringהכתובת לתשובה
subjectStringשורת הנושא
bodyStringגוף האימייל בטקסט פשוט

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/script.send_mail