ایمیل می فرستد.
این سرویس به کاربران امکان ارسال ایمیل با کنترل کامل بر محتوای ایمیل را می دهد. برخلاف GmailApp، تنها هدف MailApp ارسال ایمیل است. MailApp نمی تواند به صندوق ورودی جیمیل کاربر دسترسی داشته باشد.
تغییرات در اسکریپت های نوشته شده با استفاده از 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 | یک شی جاوا اسکریپت که نشان دهنده یک پیام ایمیل است |
پارامترهای پیشرفته
نام | تایپ کنید | توضیحات |
---|---|---|
attachments | BlobSource[] | مجموعه ای از فایل ها برای ارسال با ایمیل |
bcc | String | فهرستی از آدرسهای ایمیل به BCC که با کاما از هم جدا شدهاند |
body | String | بدنه ایمیل |
cc | String | فهرستی از آدرسهای ایمیل به CC جدا شده با کاما |
htmlBody | String | در صورت تنظیم، دستگاه هایی که قادر به ارائه HTML هستند، از آن به جای آرگومان بدن مورد نیاز استفاده می کنند. اگر برای ایمیل خود تصاویر درون خطی دارید، می توانید یک فیلد inlineImages اختیاری در متن HTML اضافه کنید |
inlineImages | Object | یک شی جاوا اسکریپت حاوی نگاشت از کلید تصویر ( 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 | یک شی جاوا اسکریپت که پارامترهای پیشرفته را به شرح زیر مشخص می کند |
پارامترهای پیشرفته
نام | تایپ کنید | توضیحات |
---|---|---|
attachments | BlobSource[] | آرایه ای از فایل ها برای ارسال با ایمیل (به مثال مراجعه کنید) |
bcc | String | فهرستی از آدرسهای ایمیل به BCC که با کاما از هم جدا شدهاند |
cc | String | فهرستی از آدرسهای ایمیل به CC جدا شده با کاما |
htmlBody | String | در صورت تنظیم، دستگاه هایی که قادر به ارائه HTML هستند، از آن به جای آرگومان بدن مورد نیاز استفاده می کنند. اگر برای ایمیل خود تصاویر درون خطی دارید، می توانید یک فیلد inlineImages اختیاری در متن HTML اضافه کنید |
inlineImages | Object | یک شی جاوا اسکریپت حاوی نگاشت از کلید تصویر ( 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)
یک پیام ایمیل می فرستد. این روش به کاربر اجازه می دهد تا به راحتی آدرس Reply-To را برای پیام ارسال شده مشخص کند که می تواند با فرستنده متفاوت باشد.
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