שליחת אימייל.
השירות הזה מאפשר למשתמשים לשלוח אימיילים תוך שליטה מלאה על תוכן האימייל. שלא כמו 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)
תישלח הודעת אימייל.
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(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