Class MailApp

میل‌اپ

ایمیل ارسال می‌کند.

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

تغییرات در اسکریپت‌های نوشته شده با استفاده از 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 یک پیام ایمیل ارسال می‌کند.

مستندات دقیق

getRemainingDailyQuota()

تعداد گیرندگانی را که می‌توانید برای بقیه روز به آنها ایمیل ارسال کنید، برمی‌گرداند. مقدار برگردانده شده برای اجرای فعلی معتبر است و ممکن است بین اجراها متفاوت باشد.

سهمیه‌ها بر اساس تعداد گیرندگان ایمیل تعیین می‌شوند. برای اطلاعات بیشتر در مورد سهمیه‌ها، به بخش سهمیه‌های سرویس‌های گوگل مراجعه کنید.

const 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() {
  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 هستند، به جای آرگومان مورد نیاز body از آن استفاده می‌کنند؛ اگر برای ایمیل خود تصاویر درون‌خطی دارید، می‌توانید یک فیلد 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

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

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.
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 هستند، به جای آرگومان مورد نیاز body از آن استفاده می‌کنند؛ اگر برای ایمیل خود تصاویر درون‌خطی دارید، می‌توانید یک فیلد 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

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

sendEmail(to, replyTo, subject, body)

یک پیام ایمیل ارسال می‌کند. این روش به کاربر اجازه می‌دهد تا به راحتی یک آدرس پاسخ برای پیام ارسالی مشخص کند که می‌تواند با آدرس فرستنده متفاوت باشد.

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