Class MailApp

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.
App de correo electrónico

Envía un correo electrónico.

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 correo electrónico. MailApp no puede acceder a la bandeja de entrada de Gmail de un usuario.

Los cambios en las secuencias de comandos escritas con la app de Gmail tienen más probabilidades de activar una solicitud de reautorización de un usuario que de las secuencias de comandos de MailApp.

Métodos

MétodoTipo de datos que se muestraDescripción breve
getRemainingDailyQuota()IntegerMuestra la cantidad de destinatarios a los que puede enviar correos electrónicos durante el resto del día.
sendEmail(message)voidEnvía un mensaje de correo electrónico.
sendEmail(recipient, subject, body)voidEnvía un mensaje de correo electrónico.
sendEmail(recipient, subject, body, options)voidEnvía un mensaje de correo electrónico con argumentos opcionales.
sendEmail(to, replyTo, subject, body)voidEnvía un mensaje de correo electrónico.

Documentación detallada

getRemainingDailyQuota()

Muestra la cantidad de destinatarios a los que puede enviar correos electrónicos durante 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 la cuota, consulta Cuotas para los servicios de Google.

var emailQuotaRemaining = MailApp.getRemainingDailyQuota();
Logger.log("Remaining email quota: " + emailQuotaRemaining);

Volver

Integer: la cantidad de correos electrónicos restantes que la secuencia de comandos puede enviar.

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 y 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

NombreTipoDescripción
messageObjectun objeto JavaScript que representa un mensaje de correo electrónico

Parámetros avanzados

NombreTipoDescripción
attachmentsBlobSource[]un arreglo de archivos para enviar con el correo electrónico
bccStringuna lista de direcciones de correo electrónico separadas por comas a Cco
bodyStringel cuerpo del correo electrónico
ccStringuna lista de direcciones de correo electrónico separadas por coma a Cc
htmlBodyStringSi se configura, los dispositivos capaces de procesar HTML lo usarán en lugar del argumento de cuerpo obligatorio. Puedes agregar un campo inlineImages opcional en el cuerpo HTML si tienes imágenes intercaladas en tu correo electrónico.
inlineImagesObjectun objeto JavaScript que contiene una asignación de la clave de imagen (String) a los datos de imagen (BlobSource); se supone que se usa el parámetro htmlBody y que contiene referencias a estas imágenes en el formato <img src="cid:imageKey" /> (ver ejemplo)
nameStringel nombre del remitente del correo electrónico. El valor predeterminado es el nombre de usuario del remitente.
noReplyBooleantrue si el correo electrónico debe enviarse desde una dirección de correo electrónico genérica que no responda a fin de disuadir a los destinatarios de responder a los mensajes. Esta opción solo es posible para las cuentas de Google Workspace, no para los usuarios de Gmail.
replyToStringuna dirección de correo electrónico para usar como dirección de respuesta predeterminada (opción predeterminada: la dirección de correo electrónico del usuario) Si noReply está configurado como true, se ignora replyTo.
subjectStringel asunto del correo electrónico
toStringla dirección de correo electrónico del destinatario o una lista de direcciones de correo electrónico separadas por comas 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

NombreTipoDescripción
recipientStringlas direcciones de los destinatarios, separadas por comas
subjectStringel asunto
bodyStringel 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 mensaje de 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

NombreTipoDescripción
recipientStringlas direcciones de los destinatarios, separadas por comas
subjectStringel asunto
bodyStringel cuerpo del correo electrónico
optionsObjectun objeto JavaScript que especifica parámetros avanzados, como se indica a continuación

Parámetros avanzados

NombreTipoDescripción
attachmentsBlobSource[]un arreglo de archivos para enviar con el correo electrónico (consulta el ejemplo)
bccStringuna lista de direcciones de correo electrónico separadas por comas a Cco
ccStringuna lista de direcciones de correo electrónico separadas por coma a Cc
htmlBodyStringSi se configura, los dispositivos capaces de procesar HTML lo usarán en lugar del argumento de cuerpo obligatorio. Puedes agregar un campo inlineImages opcional en el cuerpo HTML si tienes imágenes intercaladas en tu correo electrónico.
inlineImagesObjectun objeto JavaScript que contiene una asignación de la clave de imagen (String) a los datos de imagen (BlobSource); se supone que se usa el parámetro htmlBody y que contiene referencias a estas imágenes en el formato <img src="cid:imageKey" />
nameStringel nombre del remitente del correo electrónico (predeterminado: el nombre del usuario)
noReplyBooleantrue si el correo electrónico debe enviarse desde una dirección de correo electrónico genérica que no responda a fin de disuadir a los destinatarios de responder a los mensajes. Esta opción solo es posible para las cuentas de Google Workspace, no para los usuarios de Gmail.
replyToStringuna dirección de correo electrónico para usar como dirección de respuesta predeterminada (opció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 fácilmente una dirección de respuesta para el mensaje enviado que puede diferir del remitente.

MailApp.sendEmail("recipient@example.com",
                  "replies@example.com",
                  "TPS report status",
                  "What is the status of those TPS reports?");

Parámetros

NombreTipoDescripción
toStringlas direcciones de los destinatarios, separadas por comas
replyToStringla dirección de respuesta
subjectStringel asunto
bodyStringel 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