Class MailApp

MailApp

Envía correos electrónicos.

Este servicio permite a los usuarios enviar correos electrónicos con control total sobre el contenido de estos. A diferencia de GmailApp, el único propósito de MailApp es enviar correos electrónicos. MailApp no puede acceder a la cuenta de Gmail de un usuario. Recibidos.

Es más probable que los cambios en las secuencias de comandos que se escriben con GmailApp activen una 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 por 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)voidSe enví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 puedes enviar correos electrónicos por el resto del día. El valor devuelto 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 Google Servicios

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

Volver

Integer: 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 de 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 agregar en Cc
htmlBodyStringSi está establecido, los dispositivos capaces de renderizar el código HTML lo usarán en su lugar. del argumento body requerido; puedes agregar un campo inlineImages opcional en HTML cuerpo si tienes imágenes intercaladas para tu correo electrónico
inlineImagesObjectun objeto de JavaScript que contiene una asignación de la clave de imagen (String) a datos de imágenes (BlobSource); En este ejemplo, 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. La configuración predeterminada es la dirección nombre de usuario.
noReplyBooleantrue si el correo electrónico debe enviarse desde un formato genérico direcciones de correo electrónico sin respuesta para disuadir a los destinatarios de responder los correos electrónicos; esta opción es 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 (predeterminado: 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 que las direcciones de correo electrónico sean 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)

Se 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
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 (ver 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 agregar en Cc
htmlBodyStringSi está establecido, los dispositivos capaces de renderizar el código HTML lo usarán en su lugar. del argumento body requerido; puedes agregar un campo inlineImages opcional en HTML cuerpo si tienes imágenes intercaladas para tu correo electrónico
inlineImagesObjectun objeto de JavaScript que contiene una asignación de la clave de imagen (String) a datos de imágenes (BlobSource); Esto supone que se usa el parámetro htmlBody y 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 un formato genérico direcciones de correo electrónico sin respuesta para disuadir a los destinatarios de responder correos electrónicos esta opción es 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 (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 al usuario especificar fácilmente una dirección de respuesta para el mensaje enviado que puede ser diferente 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