Class MailApp

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: "[email protected]",
    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 ישתמשו בו של ארגומנט הגוף הנדרש; אפשר להוסיף שדה inlineImages ב-HTML גוף ההודעה אם יש תמונות בגוף ההודעה
inlineImagesObjectאובייקט JavaScript שמכיל מיפוי ממפתח תמונה (String) לנתוני התמונה (BlobSource); ההנחה היא שנעשה שימוש בפרמטר htmlBody ומכיל הפניות לתמונות האלה בפורמט <img src="cid:imageKey" /> (ראו דוגמה)
nameStringהשם של שולח האימייל. ברירת המחדל היא של השולח שם משתמש.
noReplyBooleantrue אם האימייל צריך להישלח מכתובת אימייל כללית כתובת אימייל ללא מענה, כדי למנוע מהנמענים להשיב לאימיילים. האפשרות הזאת היא הדבר אפשרי רק בחשבונות Google Workspace ולא למשתמשי Gmail
replyToStringכתובת אימייל שתשמש כברירת המחדל לתשובה (ברירת מחדל: כתובת האימייל של המשתמש). אם המדיניות noReply מוגדרת לערך true, המערכת תתעלם מ-replyTo.
subjectStringנושא האימייל
toStringכתובת האימייל של הנמען או רשימה מופרדת בפסיקים של כתובות האימייל שיהיו הנמענים

אישור

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

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

ראה גם


sendEmail(recipient, subject, body)

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

MailApp.sendEmail("[email protected]",
                  "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.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var blob = Utilities.newBlob('Insert any HTML content here', 'text/html', 'my_document.html');
MailApp.sendEmail('[email protected]', '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 ישתמשו בו של ארגומנט הגוף הנדרש; אפשר להוסיף שדה inlineImages ב-HTML גוף ההודעה אם יש תמונות בגוף ההודעה
inlineImagesObjectאובייקט JavaScript שמכיל מיפוי ממפתח תמונה (String) לנתוני התמונה (BlobSource); ההנחה היא שנעשה שימוש בפרמטר htmlBody והוא מכיל הפניות לתמונות האלה בפורמט <img src="cid:imageKey" />
nameStringשם השולח של הודעת האימייל (ברירת המחדל: שם המשתמש)
noReplyBooleantrue אם האימייל צריך להישלח מכתובת אימייל כללית כתובת אימייל ללא מענה, כדי למנוע מהנמענים להשיב לאימיילים. האפשרות הזאת היא הדבר אפשרי רק בחשבונות Google Workspace ולא למשתמשי Gmail
replyToStringכתובת אימייל שתשמש כברירת המחדל לתשובה (ברירת מחדל: כתובת האימייל של המשתמש)

אישור

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

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

ראה גם


sendEmail(to, replyTo, subject, body)

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

MailApp.sendEmail("[email protected]",
                  "[email protected]",
                  "TPS report status",
                  "What is the status of those TPS reports?");

פרמטרים

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

אישור

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

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