Se usó la API de Cloud Translation para traducir esta página.

Class MailApp

Envía un correo electrónico.

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

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é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 durante 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 mensaje de 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 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 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 ámbitos:

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

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 de direcciones de correo electrónico separadas por comas para 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 establece, 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.
`inlineImages`	`Object`	Un objeto JavaScript que contiene una asignación de la clave de imagen (`String`) a los datos de 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).
`name`	`String`	el nombre del remitente del correo electrónico El valor predeterminado es el nombre de usuario del remitente.
`noReply`	`Boolean`	`true` si el correo electrónico se debe enviar desde una dirección genérica de correo electrónico sin respuesta para disuadir a los destinatarios de responder los correos electrónicos. Esta opción solo es posible para las cuentas de Google Workspace, no para los usuarios de Gmail.
`replyTo`	`String`	Una dirección de correo electrónico que se usará como dirección de respuesta predeterminada (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 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 ámbitos:

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

Consulta también

sendEmail(recipient, subject, body, options)

`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`	el 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 ámbitos:

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

Nombre	Tipo	Descripción
`recipient`	`String`	las direcciones de los destinatarios, separadas por comas
`subject`	`String`	el asunto
`body`	`String`	el cuerpo del correo electrónico
`options`	`Object`	Un objeto 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 de direcciones de correo electrónico separadas por comas para CCO
`cc`	`String`	una lista de direcciones de correo electrónico separadas por comas para incluir en Cc
`htmlBody`	`String`	Si se establece, 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.
`inlineImages`	`Object`	Un objeto JavaScript que contiene una asignación de la clave de imagen (`String`) a los datos de 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" />`
`name`	`String`	el nombre del remitente del correo electrónico (predeterminado: el nombre del usuario)
`noReply`	`Boolean`	`true` si el correo electrónico se debe enviar desde una dirección genérica de correo electrónico sin respuesta para disuadir a los destinatarios de responder los correos electrónicos. Esta opción solo es posible para las cuentas de Google Workspace, no para los usuarios de Gmail.
`replyTo`	`String`	Una dirección de correo electrónico que se usará como la 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 ámbitos:

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

Consulta también

sendEmail(message)

`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 Reply-To 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

Nombre	Tipo	Descripción
`to`	`String`	las direcciones de los destinatarios, separadas por comas
`replyTo`	`String`	la dirección de respuesta
`subject`	`String`	el 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 ámbitos:

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