Envía correos electrónicos.
Este servicio permite a los usuarios enviar correos electrónicos con control total sobre su contenido. A diferencia de GmailApp, el único propósito de MailApp es enviar correos electrónicos. MailApp no puede acceder a la bandeja de entrada de Gmail de un usuario.
Los cambios en las secuencias de comandos escritas con GmailApp tienen más probabilidades de activar una solicitud de nueva autorización de un usuario que las secuencias de comandos de MailApp.
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
getRemainingDailyQuota() | Integer | Muestra la cantidad de destinatarios a los que puedes enviar correos electrónicos para el resto del día. |
sendEmail(message) | void | Envía un mensaje de correo electrónico. |
sendEmail(recipient, subject, body) | void | Envía un mensaje de correo electrónico. |
sendEmail(recipient, subject, body, options) | void | Envía un correo electrónico con argumentos opcionales. |
sendEmail(to, replyTo, subject, body) | void | Envía un mensaje de correo electrónico. |
Documentación detallada
getRemainingDailyQuota()
Muestra la cantidad de destinatarios a los que puedes enviar correos electrónicos para el resto del día. El valor que se muestra es válido para la ejecución actual y puede variar entre ejecuciones.
Las cuotas se basan en la cantidad de destinatarios de correo electrónico. Para obtener información específica sobre las cuotas, consulta Cuotas para los servicios de Google.
var emailQuotaRemaining = MailApp.getRemainingDailyQuota(); Logger.log("Remaining email quota: " + emailQuotaRemaining);
Devolvedor
Integer
: Es la cantidad de correos electrónicos restantes que puede enviar la secuencia de comandos.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.send_mail
sendEmail(message)
Envía un mensaje de correo electrónico. Esta variación del método es mucho más flexible, lo que permite muchas más opciones.
// 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 } }); }
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
message | Object | un objeto JavaScript que representa un mensaje de correo electrónico |
Parámetros avanzados
Nombre | Tipo | Descripción |
---|---|---|
attachments | BlobSource[] | un array de archivos para enviar con el correo electrónico |
bcc | String | una lista separada por comas de direcciones de correo electrónico a Cco |
body | String | el cuerpo del correo electrónico |
cc | String | una lista de direcciones de correo electrónico separadas por comas para incluir en Cc |
htmlBody | String | Si se configura, los dispositivos capaces de renderizar HTML lo usarán en lugar del argumento del cuerpo obligatorio. Puedes agregar un campo opcional inlineImages en el cuerpo HTML si tienes imágenes intercaladas para tu correo electrónico. |
inlineImages | Object | un objeto JavaScript que contiene una asignación de la clave de imagen (String ) a los datos de la imagen (BlobSource ); esto supone que se usa el parámetro htmlBody y que contiene referencias a estas imágenes en el formato <img src="cid:imageKey" /> (consulta el ejemplo) |
name | String | el nombre del remitente del correo electrónico. La configuración predeterminada es el nombre de usuario del remitente. |
noReply | Boolean | true si el correo electrónico se debe enviar desde una dirección genérica que no recibe respuestas, a fin de evitar que los destinatarios respondan los correos electrónicos. Esta opción solo es posible para cuentas de Google Workspace, no para usuarios de Gmail. |
replyTo | String | una dirección de correo electrónico para usar como dirección de respuesta predeterminada (configuración predeterminada: la dirección de correo electrónico del usuario) Si noReply está configurado como true , se ignora replyTo . |
subject | String | el asunto del correo electrónico |
to | String | la dirección de correo electrónico del destinatario o una lista separada por comas de direcciones de correo electrónico que serán los destinatarios |
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.send_mail
Consulta también
sendEmail(recipient, subject, body)
Envía un mensaje de correo electrónico.
MailApp.sendEmail("recipient@example.com", "TPS reports", "Where are the TPS reports?");
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
recipient | String | las direcciones de los destinatarios separadas por comas |
subject | String | la línea de asunto |
body | String | el cuerpo del correo electrónico |
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.send_mail
sendEmail(recipient, subject, body, options)
Envía un correo electrónico con argumentos opcionales.
// 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] });
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
recipient | String | las direcciones de los destinatarios separadas por comas |
subject | String | la línea de asunto |
body | String | el cuerpo del correo electrónico |
options | Object | un objeto de JavaScript que especifica parámetros avanzados, como se indica a continuación |
Parámetros avanzados
Nombre | Tipo | Descripción |
---|---|---|
attachments | BlobSource[] | Un array de archivos para enviar con el correo electrónico (consulta el ejemplo) |
bcc | String | una lista separada por comas de direcciones de correo electrónico a Cco |
cc | String | una lista de direcciones de correo electrónico separadas por comas para incluir en Cc |
htmlBody | String | Si se configura, los dispositivos capaces de renderizar HTML lo usarán en lugar del argumento del cuerpo obligatorio. Puedes agregar un campo opcional inlineImages en el cuerpo HTML si tienes imágenes intercaladas para tu correo electrónico. |
inlineImages | Object | un objeto JavaScript que contiene una asignación de la clave de imagen (String ) a los datos de la imagen (BlobSource ); esto supone que se usa el parámetro htmlBody y que contiene referencias a estas imágenes en el formato <img src="cid:imageKey" /> |
name | String | el nombre del remitente del correo electrónico (configuración predeterminada: el nombre del usuario) |
noReply | Boolean | true si el correo electrónico se debe enviar desde una dirección genérica que no recibe respuestas, a fin de evitar que los destinatarios respondan los correos electrónicos. Esta opción solo es posible para cuentas de Google Workspace, no para usuarios de Gmail. |
replyTo | String | una dirección de correo electrónico para usar como dirección de respuesta predeterminada (configuración predeterminada: la dirección de correo electrónico del usuario) |
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.send_mail
Consulta también
sendEmail(to, replyTo, subject, body)
Envía un mensaje de correo electrónico. Este método permite que un usuario especifique con facilidad una dirección de respuesta para el mensaje enviado que puede diferir de la del remitente.
MailApp.sendEmail("recipient@example.com", "replies@example.com", "TPS report status", "What is the status of those TPS reports?");
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
to | String | las direcciones de los destinatarios separadas por comas |
replyTo | String | la dirección de respuesta |
subject | String | la línea de asunto |
body | String | el cuerpo del correo electrónico en texto sin formato |
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.send_mail