דף זה תורגם על ידי 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