נשלח אימייל.
השירות הזה מאפשר למשתמשים לשלוח אימיילים ולשלוט בתוכן של ההודעה. בניגוד ל-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 } }); }
פרמטרים
שם | סוג | תיאור |
---|---|---|
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("[email protected]", "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('[email protected]', '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("[email protected]", "[email protected]", "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