Class MailApp

Mailऐप्लिकेशन

ईमेल भेजता है.

इस सेवा की मदद से, उपयोगकर्ता ईमेल भेज सकते हैं. साथ ही, ईमेल के कॉन्टेंट पर पूरा कंट्रोल भी रख सकते हैं. GmailApp के उलट, MailApp का मकसद सिर्फ़ ईमेल भेजना है. MailApp, किसी उपयोगकर्ता के Gmail इनबॉक्स को ऐक्सेस नहीं कर सकता.

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 की सेवाओं के लिए कोटा देखें.

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,
    },
  });
}

पैरामीटर

नामटाइपब्यौरा
messageObjectईमेल मैसेज दिखाने वाला JavaScript ऑब्जेक्ट

उन्नत पैरामीटर

नामटाइपब्यौरा
attachmentsBlobSource[]ईमेल के साथ भेजने के लिए, फ़ाइलों का कलेक्शन
bccStringकॉमा लगाकर अलग किए गए ईमेल पतों की सूची, जिन्हें गुप्त कॉपी में शामिल करना है
bodyStringईमेल का मुख्य हिस्सा
ccStringकॉमा लगाकर अलग किए गए वे ईमेल पते जिन पर ईमेल की कॉपी भेजनी है
htmlBodyStringअगर यह सेट है, तो एचटीएमएल रेंडर करने वाले डिवाइस, ज़रूरी बॉडी आर्ग्युमेंट के बजाय इसका इस्तेमाल करेंगे; अगर आपने अपने ईमेल के लिए इमेज इनलाइन की हैं, तो एचटीएमएल बॉडी में वैकल्पिक inlineImages फ़ील्ड जोड़ा जा सकता है
inlineImagesObjectJavaScript ऑब्जेक्ट, जिसमें इमेज की कुंजी (String) से इमेज डेटा (BlobSource) तक मैपिंग होती है. यह माना जाता है कि htmlBody पैरामीटर का इस्तेमाल किया गया है और इसमें <img src="cid:imageKey" /> फ़ॉर्मैट में इन इमेज के रेफ़रंस शामिल हैं (उदाहरण देखें)
nameStringईमेल भेजने वाले का नाम. डिफ़ॉल्ट रूप से, यह ईमेल भेजने वाले व्यक्ति के उपयोगकर्ता नाम पर सेट होता है.
noReplyBooleantrue अगर ईमेल को किसी सामान्य, 'जवाब न दें' ईमेल पते से भेजना है, ताकि ईमेल पाने वाले लोग उस पर जवाब न दें. यह विकल्प सिर्फ़ Google Workspace खातों के लिए उपलब्ध है, न कि Gmail उपयोगकर्ताओं के लिए
replyToStringजवाब देने के लिए डिफ़ॉल्ट ईमेल पते के तौर पर इस्तेमाल किया जाने वाला ईमेल पता (डिफ़ॉल्ट: उपयोगकर्ता का ईमेल पता). अगर noReply को true पर सेट किया गया है, तो replyTo को अनदेखा कर दिया जाता है.
subjectStringईमेल का विषय
toStringईमेल पाने वाले का ईमेल पता या ईमेल पाने वाले लोगों के ईमेल पतों की कॉमा लगाकर अलग की गई सूची

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

इन्हें भी देखें


sendEmail(recipient, subject, body)

ईमेल मैसेज भेजता है.

MailApp.sendEmail(
    'recipient@example.com',
    'TPS reports',
    'Where are the TPS reports?',
);

पैरामीटर

नामटाइपब्यौरा
recipientStringईमेल पाने वालों के पते, कॉमा लगाकर अलग किए गए
subjectStringविषय
bodyStringईमेल का मुख्य हिस्सा

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • 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],
    },
);

पैरामीटर

नामटाइपब्यौरा
recipientStringईमेल पाने वालों के पते, कॉमा लगाकर अलग किए गए
subjectStringविषय
bodyStringईमेल का मुख्य हिस्सा
optionsObjectएक JavaScript ऑब्जेक्ट, जो बेहतर पैरामीटर की जानकारी देता है. इन पैरामीटर की सूची यहां दी गई है

उन्नत पैरामीटर

नामटाइपब्यौरा
attachmentsBlobSource[]ईमेल के साथ भेजने के लिए, फ़ाइलों का कलेक्शन (उदाहरण देखें)
bccStringकॉमा लगाकर अलग किए गए ईमेल पतों की सूची, जिन्हें गुप्त कॉपी में शामिल करना है
ccStringकॉमा लगाकर अलग किए गए वे ईमेल पते जिन पर ईमेल की कॉपी भेजनी है
htmlBodyStringअगर यह सेट है, तो एचटीएमएल रेंडर करने वाले डिवाइस, ज़रूरी बॉडी आर्ग्युमेंट के बजाय इसका इस्तेमाल करेंगे; अगर आपने अपने ईमेल के लिए इमेज इनलाइन की हैं, तो एचटीएमएल बॉडी में वैकल्पिक inlineImages फ़ील्ड जोड़ा जा सकता है
inlineImagesObjectJavaScript ऑब्जेक्ट, जिसमें इमेज की मुख्य जानकारी (String) से इमेज डेटा (BlobSource) तक की मैपिंग होती है. यह माना जाता है कि htmlBody पैरामीटर का इस्तेमाल किया गया है और इसमें <img src="cid:imageKey" /> फ़ॉर्मैट में इन इमेज के रेफ़रंस शामिल हैं
nameStringईमेल भेजने वाले का नाम (डिफ़ॉल्ट: उपयोगकर्ता का नाम)
noReplyBooleantrue अगर ईमेल को किसी सामान्य, 'जवाब न दें' ईमेल पते से भेजना है, ताकि ईमेल पाने वाले लोग उस पर जवाब न दें. यह विकल्प सिर्फ़ Google Workspace खातों के लिए उपलब्ध है, न कि Gmail उपयोगकर्ताओं के लिए
replyToStringजवाब देने के लिए डिफ़ॉल्ट ईमेल पता (डिफ़ॉल्ट: उपयोगकर्ता का ईमेल पता)

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

  • 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?',
);

पैरामीटर

नामटाइपब्यौरा
toStringईमेल पाने वालों के पते, कॉमा लगाकर अलग किए गए
replyToStringजवाब देने का पता
subjectStringविषय
bodyStringईमेल का मुख्य हिस्सा सादे टेक्स्ट में

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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