Class MailApp

MailApp

Envía correos electrónicos.

Este servicio permite a los usuarios enviar correos electrónicos con control total sobre el contenido del correo electrónico. 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.

Es más probable que los cambios en las secuencias de comandos escritas con GmailApp activen una solicitud de reautorización de un usuario que las secuencias de comandos de MailApp.

Métodos

MétodoTipo de datos que se devuelveDescripció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)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 puedes enviar correos electrónicos por 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 de los servicios de Google. 

const emailQuotaRemaining = MailApp.getRemainingDailyQuota();
Logger.log(`Remaining email quota: ${emailQuotaRemaining}`);

Volver

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 permisos:

  • 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() {
  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,
    },
  });
}

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 de direcciones de correo electrónico separadas por comas para enviar con CCO
bodyStringel cuerpo del correo electrónico
ccStringuna lista de direcciones de correo electrónico separadas por comas para enviar con CC
htmlBodyStringsi se configura, los dispositivos capaces de renderizar 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 para tu correo electrónico
inlineImagesObjectun objeto de 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 contiene referencias a estas imágenes en el formato <img src="cid:imageKey" /> (consulta el 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 se debe enviar desde una dirección de correo electrónico genérica de no respuesta para evitar que los destinatarios respondan a los correos electrónicos; 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 (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 de direcciones de correo electrónico separadas por comas para que 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 permisos:

  • 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 permisos:

  • 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.
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],
    },
);

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 de direcciones de correo electrónico separadas por comas para enviar con CCO
ccStringuna lista de direcciones de correo electrónico separadas por comas para enviar con CC
htmlBodyStringsi se configura, los dispositivos capaces de renderizar 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 para tu correo electrónico
inlineImagesObjectun objeto de 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 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 se debe enviar desde una dirección de correo electrónico genérica de no respuesta para evitar que los destinatarios respondan a los correos electrónicos; 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 (predeterminado: 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 permisos:

  • 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
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 permisos:

  • https://www.googleapis.com/auth/script.send_mail