این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class 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, options)

`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(message)

`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