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

Class MailApp

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

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

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

שיטות

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

תיעוד מפורט

`getRemainingDailyQuota()`

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

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

var 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() {
  var googleLogoUrl = "https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png";
  var youtubeLogoUrl =
        "https://developers.google.com/youtube/images/YouTube_logo_standard_white.png";
  var googleLogoBlob = UrlFetchApp
                         .fetch(googleLogoUrl)
                         .getBlob()
                         .setName("googleLogoBlob");
  var 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 ישתמשו בו במקום בארגומנט הנדרש; אפשר להוסיף שדה `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.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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 ישתמשו בו במקום בארגומנט הנדרש; אפשר להוסיף שדה `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)`

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

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