Class MailApp

برنامه ایمیل

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

این سرویس به کاربران امکان ارسال ایمیل با کنترل کامل بر محتوای ایمیل را می دهد. برخلاف GmailApp، تنها هدف MailApp ارسال ایمیل است. MailApp نمی تواند به صندوق ورودی جیمیل کاربر دسترسی داشته باشد.

تغییرات در اسکریپت های نوشته شده با استفاده از GmailApp بیشتر از اسکریپت های MailApp باعث درخواست مجوز مجدد از یک کاربر می شود.

روش ها

روش نوع برگشت شرح مختصر
get Remaining Daily Quota() Integer تعداد گیرندگانی را که می‌توانید در بقیه روز به آنها ایمیل بفرستید، برمی‌گرداند.
send Email(message) void یک پیام ایمیل می فرستد.
send Email(recipient, subject, body) void یک پیام ایمیل می فرستد.
send Email(recipient, subject, body, options) void یک پیام ایمیل با آرگومان های اختیاری ارسال می کند.
send Email(to, replyTo, subject, body) 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 یک شی جاوا اسکریپت که نشان دهنده یک پیام ایمیل است

پارامترهای پیشرفته

نام تایپ کنید توضیحات
attachments Blob Source[] مجموعه ای از فایل ها برای ارسال با ایمیل
bcc String فهرستی از آدرس‌های ایمیل به BCC که با کاما از هم جدا شده‌اند
body String بدنه ایمیل
cc String فهرستی از آدرس‌های ایمیل به CC جدا شده با کاما
html Body String در صورت تنظیم، دستگاه هایی که قادر به ارائه HTML هستند، از آن به جای آرگومان بدن مورد نیاز استفاده می کنند. اگر تصاویر درون خطی برای ایمیل خود دارید، می توانید یک فیلد inline Images اختیاری در متن HTML اضافه کنید
inline Images Object یک شی جاوا اسکریپت حاوی نگاشت از کلید تصویر ( String ) به داده های تصویر ( Blob Source ) . فرض بر این است که پارامتر html Body استفاده شده است و حاوی ارجاعاتی به این تصاویر در قالب <img src="cid:imageKey" /> (به مثال مراجعه کنید)
name String نام فرستنده ایمیل پیش فرض نام کاربری فرستنده است.
no Reply Boolean true اگر ایمیل باید از یک آدرس ایمیل عمومی بدون پاسخ ارسال شود تا گیرندگان را از پاسخ دادن به ایمیل ها منصرف کند. این گزینه فقط برای حساب های Google Workspace امکان پذیر است، نه کاربران Gmail
reply To String یک آدرس ایمیل برای استفاده به عنوان آدرس پیش فرض پاسخ به (پیش فرض: آدرس ایمیل کاربر). اگر no Reply روی true تنظیم نشده باشد، reply To نادیده گرفته می شود.
subject String موضوع ایمیل
to String آدرس ایمیل گیرنده یا فهرستی از آدرس‌های ایمیل جدا شده با کاما برای گیرندگان

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/script.send_mail

همچنین ببینید

send Email(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

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 یک شی جاوا اسکریپت که پارامترهای پیشرفته را به شرح زیر مشخص می کند

پارامترهای پیشرفته

نام تایپ کنید توضیحات
attachments Blob Source[] آرایه ای از فایل ها برای ارسال با ایمیل (به مثال مراجعه کنید)
bcc String فهرستی از آدرس‌های ایمیل به BCC که با کاما از هم جدا شده‌اند
cc String فهرستی از آدرس‌های ایمیل به CC جدا شده با کاما
html Body String در صورت تنظیم، دستگاه هایی که قادر به ارائه HTML هستند، از آن به جای آرگومان بدن مورد نیاز استفاده می کنند. اگر تصاویر درون خطی برای ایمیل خود دارید، می توانید یک فیلد inline Images اختیاری در متن HTML اضافه کنید
inline Images Object یک شی جاوا اسکریپت حاوی نگاشت از کلید تصویر ( String ) به داده های تصویر ( Blob Source ) . فرض بر این است که پارامتر html Body استفاده شده است و حاوی ارجاعاتی به این تصاویر در قالب <img src="cid:imageKey" /> است.
name String نام فرستنده ایمیل (پیش‌فرض: نام کاربر)
no Reply Boolean true اگر ایمیل باید از یک آدرس ایمیل عمومی بدون پاسخ ارسال شود تا گیرندگان را از پاسخ دادن به ایمیل ها منصرف کند. این گزینه فقط برای حساب های Google Workspace امکان پذیر است، نه کاربران Gmail
reply To String یک آدرس ایمیل برای استفاده به عنوان آدرس پیش فرض پاسخ به (پیش فرض: آدرس ایمیل کاربر)

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/script.send_mail

همچنین ببینید

send Email(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 آدرس گیرندگان که با کاما از هم جدا شده اند
reply To String آدرس پاسخ به
subject String خط موضوع
body String متن ایمیل به صورت متن ساده

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/script.send_mail