שליחת אימייל.
השירות הזה מאפשר למשתמשים לשלוח אימיילים עם שליטה מלאה על תוכן האימייל. בניגוד ל-GmailApp, המטרה היחידה של MailApp היא שליחת אימייל. ל-MailApp אין גישה לתיבת הדואר הנכנס של המשתמש ב-Gmail.
סביר יותר ששינויים בסקריפטים שנכתבו באמצעות GmailApp יגרמו לבקשת הרשאה מחדש ממשתמש, בהשוואה לסקריפטים של MailApp.
Methods
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
get | Integer | הפונקציה מחזירה את מספר הנמענים שאפשר לשלוח אליהם אימיילים עד סוף היום. |
send | void | שליחת הודעת אימייל. |
send | void | שליחת הודעת אימייל. |
send | void | שליחת הודעת אימייל עם ארגומנטים אופציונליים. |
send | void | שליחת הודעת אימייל. |
מסמכים מפורטים
get Remaining Daily Quota()
הפונקציה מחזירה את מספר הנמענים שאפשר לשלוח אליהם אימיילים עד סוף היום. הערך המוחזר תקף להפעלה הנוכחית, ויכול להשתנות בין הפעלות.
המכסות מבוססות על מספר הנמענים באימייל. מידע ספציפי על המכסות זמין במאמר מכסות לשירותי Google.
const emailQuotaRemaining = MailApp.getRemainingDailyQuota(); Logger.log(`Remaining email quota: ${emailQuotaRemaining}`);
חזרה
Integer
– מספר האימיילים שנותרו שאפשר לשלוח באמצעות הסקריפט.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/script.send_mail
send Email(message)
שליחת הודעת אימייל. הגרסה הזו של השיטה היא גמישה הרבה יותר ומאפשרת הרבה יותר אפשרויות.
// This code fetches the Google and YouTube logos, inlines them in an email // and sends the email function inlineImage() { const googleLogoUrl = 'https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png'; const youtubeLogoUrl = 'https://developers.google.com/youtube/images/YouTube_logo_standard_white.png'; const googleLogoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob().setName('googleLogoBlob'); const 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 | Blob | מערך של קבצים שרוצים לשלוח באימייל |
bcc | String | רשימה של כתובות אימייל שמופרדות בפסיקים, לצורך שליחת עותק מוסתר |
body | String | גוף האימייל |
cc | String | רשימה מופרדת בפסיקים של כתובות אימייל לשליחת עותק |
html | String | אם השדה מוגדר, מכשירים שיכולים להציג HTML ישתמשו בו במקום בארגומנט הנדרש body. אפשר להוסיף שדה inline אופציונלי בגוף ה-HTML אם יש תמונות מוטמעות באימייל. |
inline | Object | אובייקט JavaScript שמכיל מיפוי ממפתח התמונה (String ) לנתוני התמונה (Blob ). ההנחה היא שמשתמשים בפרמטר html והוא מכיל הפניות לתמונות האלה בפורמט <img src="cid:imageKey" /> (ראו דוגמה) |
name | String | השם של השולח של האימייל. ברירת המחדל היא שם המשתמש של השולח. |
no | Boolean | true אם האימייל צריך להישלח מכתובת אימייל גנרית ללא מענה כדי למנוע מהנמענים להשיב לאימיילים. האפשרות הזו זמינה רק לחשבונות Google Workspace, ולא למשתמשי Gmail. |
reply | String | כתובת אימייל שישמש ככתובת ברירת המחדל לתשובות (ברירת המחדל: כתובת האימייל של המשתמש). אם no מוגדרת כ-true , המערכת מתעלמת מ-reply . |
subject | String | נושא האימייל |
to | String | כתובת האימייל של הנמען או רשימה של כתובות אימייל שמופרדות בפסיקים, שיהיו הנמענים |
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/script.send_mail
ראה גם
send Email(recipient, subject, body)
שליחת הודעת אימייל.
App .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
send Email(recipient, subject, body, options)
שליחת הודעת אימייל עם ארגומנטים אופציונליים.
// Send an email with two attachments: a file from Google Drive (as a PDF) and // an HTML file. const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz'); const 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 | Blob | מערך של קבצים שרוצים לשלוח עם האימייל (ראו דוגמה) |
bcc | String | רשימה של כתובות אימייל שמופרדות בפסיקים, לצורך שליחת עותק מוסתר |
cc | String | רשימה מופרדת בפסיקים של כתובות אימייל לשליחת עותק |
html | String | אם השדה מוגדר, מכשירים שיכולים להציג HTML ישתמשו בו במקום בארגומנט הנדרש body. אפשר להוסיף שדה inline אופציונלי בגוף ה-HTML אם יש תמונות מוטמעות באימייל. |
inline | Object | אובייקט JavaScript שמכיל מיפוי ממפתח תמונה (String ) לנתוני תמונה (Blob ). ההנחה היא שמשתמשים בפרמטר html והוא מכיל הפניות לתמונות האלה בפורמט <img src="cid:imageKey" /> |
name | String | השם של השולח של האימייל (ברירת המחדל: שם המשתמש) |
no | Boolean | true אם האימייל צריך להישלח מכתובת אימייל גנרית ללא מענה כדי למנוע מהנמענים להשיב לאימיילים. האפשרות הזו זמינה רק לחשבונות Google Workspace, ולא למשתמשי Gmail. |
reply | String | כתובת אימייל שישמש ככתובת ברירת המחדל לתשובות (ברירת המחדל: כתובת האימייל של המשתמש) |
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/script.send_mail
ראה גם
send Email(to, replyTo, subject, body)
שליחת הודעת אימייל. השיטה הזו מאפשרת למשתמש לציין בקלות כתובת Reply-To להודעה שנשלחה, שיכולה להיות שונה מכתובת השולח.
App .sendEmail( 'recipient@example.com', 'replies@example.com', 'TPS report status', 'What is the status of those TPS reports?', );
פרמטרים
שם | סוג | תיאור |
---|---|---|
to | String | הכתובות של הנמענים, מופרדות בפסיקים |
reply | String | כתובת התשובה |
subject | String | שורת הנושא |
body | String | גוף האימייל כטקסט פשוט |
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/script.send_mail