Class MailApp

MailApp

ایمیل می فرستد.

این سرویس به کاربران امکان ارسال ایمیل با کنترل کامل بر محتوای ایمیل را می دهد. برخلاف 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