Class MailApp

MailApp

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étodoTipo de datos que se muestraDescripción breve
getRemainingDailyQuota()IntegerMuestra la cantidad de destinatarios a los que puedes enviar correos electrónicos para 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 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 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

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

Parámetros avanzados

NombreTipoDescripción
attachmentsBlobSource[]un array de archivos para enviar con el correo electrónico
bccStringuna lista separada por comas de direcciones de correo electrónico a Cco
bodyStringel cuerpo del correo electrónico
ccStringuna lista de direcciones de correo electrónico separadas por comas para incluir en Cc
htmlBodyStringSi 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.
inlineImagesObjectun 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)
nameStringel nombre del remitente del correo electrónico. La configuración predeterminada es el nombre de usuario del remitente.
noReplyBooleantrue 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.
replyToStringuna 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.
subjectStringel asunto del correo electrónico
toStringla 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

NombreTipoDescripción
recipientStringlas direcciones de los destinatarios separadas por comas
subjectStringla línea de 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 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
subjectStringla línea de asunto
bodyStringel cuerpo del correo electrónico
optionsObjectun objeto de JavaScript que especifica parámetros avanzados, como se indica a continuación

Parámetros avanzados

NombreTipoDescripción
attachmentsBlobSource[]Un array de archivos para enviar con el correo electrónico (consulta el ejemplo)
bccStringuna lista separada por comas de direcciones de correo electrónico a Cco
ccStringuna lista de direcciones de correo electrónico separadas por comas para incluir en Cc
htmlBodyStringSi 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.
inlineImagesObjectun 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" />
nameStringel nombre del remitente del correo electrónico (configuración predeterminada: el nombre del usuario)
noReplyBooleantrue 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.
replyToStringuna 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

NombreTipoDescripción
toStringlas direcciones de los destinatarios separadas por comas
replyToStringla dirección de respuesta
subjectStringla línea de 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