דף זה תורגם על ידי Cloud Translation API.

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

פרמטרים

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

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

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

אישור

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

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

ראה גם

sendEmail(recipient, subject, body, options)

`sendEmail(recipient, subject, body)`

שליחת הודעת אימייל.

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

פרמטרים

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

אישור

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

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

פרמטרים

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

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

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

אישור

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

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

ראה גם

sendEmail(message)

`sendEmail(to, replyTo, subject, body)`

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

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

פרמטרים

שם	סוג	תיאור
`to`	`String`	הכתובות של הנמענים, מופרדות בפסיקים
`replyTo`	`String`	כתובת התשובה
`subject`	`String`	שורת הנושא
`body`	`String`	גוף האימייל כטקסט פשוט

אישור

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

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