Stay organized with collections Save and categorize content based on your preferences.
MailAppSends email.
This service allows users to send emails with complete control over the content of the email. Unlike GmailApp, MailApp's sole purpose is sending email. MailApp cannot access a user's Gmail inbox.
Changes to scripts written using GmailApp are more likely to trigger a re-authorization request from a user than MailApp scripts.
Detailed documentationgetRemainingDailyQuota()
Returns the number of recipients you can send emails to for the rest of the day. The returned value is valid for the current execution and might vary between executions.
Quotas are based on the number of email recipients. For specific quota information, see Quotas for Google Services.
const emailQuotaRemaining = MailApp.getRemainingDailyQuota(); Logger.log(`Remaining email quota: ${emailQuotaRemaining}`);Return
Integer
— The number of emails remaining that the script can send.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/script.send_mail
sendEmail(message)
Sends an email message. This variation of the method is much more flexible, allowing for many more options.
// 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, }, }); }Parameters Name Type Description
message
Object
a JavaScript object representing an email message Advanced parameters Name Type Description attachments
BlobSource[]
an array of files to send with the email bcc
String
a comma-separated list of email addresses to BCC body
String
the body of the email cc
String
a comma-separated list of email addresses to CC htmlBody
String
if set, devices capable of rendering HTML will use it instead of the required body argument; you can add an optional inlineImages
field in HTML body if you have inlined images for your email inlineImages
Object
a JavaScript object containing a mapping from image key (String
) to image data (BlobSource
); this assumes that the htmlBody
parameter is used and contains references to these images in the format <img src="cid:imageKey" />
(see example) name
String
the name of the sender of the email. Defaults to the sender's username. noReply
Boolean
true
if the email should be sent from a generic no-reply email address to discourage recipients from responding to emails; this option is only possible for Google Workspace accounts, not Gmail users replyTo
String
an email address to use as the default reply-to address (default: the user's email address). If noReply
is set to true
, replyTo
is ignored. subject
String
the subject of the email to
String
the email address of the recipient or a comma-separated list of email addresses to be the recipients Authorization
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/script.send_mail
sendEmail(recipient, subject, body)
Sends an email message.
MailApp.sendEmail( 'recipient@example.com', 'TPS reports', 'Where are the TPS reports?', );Parameters Name Type Description
recipient
String
the addresses of the recipients, separated by commas subject
String
the subject line body
String
the body of the email Authorization
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/script.send_mail
sendEmail(recipient, subject, body, options)
Sends an email message with optional arguments.
// 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], }, );Parameters Name Type Description
recipient
String
the addresses of the recipients, separated by commas subject
String
the subject line body
String
the body of the email options
Object
a JavaScript object that specifies advanced parameters, as listed below Advanced parameters Name Type Description attachments
BlobSource[]
an array of files to send with the email (see example) bcc
String
a comma-separated list of email addresses to BCC cc
String
a comma-separated list of email addresses to CC htmlBody
String
if set, devices capable of rendering HTML will use it instead of the required body argument; you can add an optional inlineImages
field in HTML body if you have inlined images for your email inlineImages
Object
a JavaScript object containing a mapping from image key (String
) to image data (BlobSource
); this assumes that the htmlBody
parameter is used and contains references to these images in the format <img src="cid:imageKey" />
name
String
the name of the sender of the email (default: the user's name) noReply
Boolean
true
if the email should be sent from a generic no-reply email address to discourage recipients from responding to emails; this option is only possible for Google Workspace accounts, not Gmail users replyTo
String
an email address to use as the default reply-to address (default: the user's email address) Authorization
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/script.send_mail
sendEmail(to, replyTo, subject, body)
Sends an email message. This method allows a user to easily specify a Reply-To address for the sent message that can differ from the sender.
MailApp.sendEmail( 'recipient@example.com', 'replies@example.com', 'TPS report status', 'What is the status of those TPS reports?', );Parameters Name Type Description
to
String
the addresses of the recipients, separated by commas replyTo
String
the reply-to address subject
String
the subject line body
String
the body of the email in plain text Authorization
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/script.send_mail
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-12-02 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-12-02 UTC."],[[["MailApp is a Google Apps Script service used to send emails, enabling control over email content but without access to a user's inbox."],["It offers flexibility in sending emails, allowing for attachments, inline images, CC, BCC, and custom reply-to addresses through various sendEmail methods."],["Unlike GmailApp, MailApp scripts are less likely to require re-authorization from the user, enhancing script stability."],["Daily email quotas apply and can be checked using getRemainingDailyQuota() to ensure scripts remain within limits."],["Scripts utilizing MailApp need authorization with the `https://www.googleapis.com/auth/script.send_mail` scope to function properly."]]],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4