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

Class GmailDraft

Un borrador de mensaje creado por un usuario en la cuenta de Gmail de un usuario.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`deleteDraft()`	`void`	Elimina este borrador del mensaje.
`getId()`	`String`	Obtiene el ID de este borrador de mensaje.
`getMessage()`	`GmailMessage`	Muestra un GmailMessage que representa este borrador.
`getMessageId()`	`String`	Muestra el ID de la `GmailMessage` que representa a este borrador.
`send()`	`GmailMessage`	Se envía este borrador de correo electrónico.
`update(recipient, subject, body)`	`GmailDraft`	Reemplaza el contenido de este borrador de mensaje.
`update(recipient, subject, body, options)`	`GmailDraft`	Reemplaza el contenido de este borrador de mensaje con argumentos opcionales.

Documentación detallada

`deleteDraft()`

Elimina este borrador del mensaje.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
draft.deleteDraft();
draft.getMessage(); // Throws exception.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances o los permisos adecuados de la API de REST relacionada:

https://mail.google.com/

`getId()`

Obtiene el ID de este borrador de mensaje.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var draftId = draft.getId();
var draftById = GmailApp.getDraft(draftId);
Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());

Devolvedor

String: Es el ID del borrador.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances o los permisos adecuados de la API de REST relacionada:

https://mail.google.com/

`getMessage()`

Muestra un GmailMessage que representa este borrador.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var message = draft.getMessage();
Logger.log(message.getSubject());

Devolvedor

GmailMessage: Es el mensaje que representa el contenido de este borrador.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances o los permisos adecuados de la API de REST relacionada:

https://mail.google.com/

`getMessageId()`

Muestra el ID de la GmailMessage que representa a este borrador.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var messageId = draft.getMessageId();
Logger.log(messageId == draft.getMessage().getId());

Devolvedor

String: Es el ID del mensaje.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances o los permisos adecuados de la API de REST relacionada:

https://mail.google.com/

`send()`

Se envía este borrador de correo electrónico. El tamaño del correo electrónico (incluidos los encabezados) tiene una cuota limitada.

var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var msg = draft.send(); // Send it
Logger.log(msg.getDate()); // Should be approximately the current timestamp

Devolvedor

GmailMessage: Es el mensaje que se envió recientemente.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances o los permisos adecuados de la API de REST relacionada:

https://mail.google.com/

`update(recipient, subject, body)`

Reemplaza el contenido de este borrador de mensaje. El tamaño del correo electrónico (incluidos los encabezados) tiene una cuota limitada.

// The code below will update a draft email with the current date and time.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var now = new Date();
draft.update("mike@example.com", "current time", "The time is: " + now.toString());

Parámetros

Nombre	Tipo	Descripción
`recipient`	`String`	lista de direcciones de correo electrónico separadas por comas
`subject`	`String`	asunto del correo electrónico (250 caracteres como máximo)
`body`	`String`	cuerpo del correo electrónico

Devolvedor

GmailDraft: Es el borrador actualizado recientemente.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances o los permisos adecuados de la API de REST relacionada:

https://mail.google.com/

Consulta también

GmailApp.createDraft(recipient, subject, body)

`update(recipient, subject, body, options)`

Reemplaza el contenido de este borrador de mensaje con argumentos opcionales. Puede contener texto sin formato o un cuerpo HTML. El tamaño del correo electrónico (incluidos los encabezados) tiene una cuota limitada.

// Update a draft email with a file from Google Drive attached as a PDF.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
draft.update('mike@example.com', 'Attachment example', 'Please see attached file.', {
    attachments: [file.getAs(MimeType.PDF)],
    name: 'Automatic Emailer Script'
});

Parámetros

Nombre	Tipo	Descripción
`recipient`	`String`	lista de direcciones de correo electrónico separadas por comas
`subject`	`String`	asunto del correo electrónico (250 caracteres como máximo)
`body`	`String`	cuerpo del correo electrónico
`options`	`Object`	un objeto de 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
`bcc`	`String`	una lista separada por comas de direcciones de correo electrónico a Cco
`cc`	`String`	una lista de direcciones de correo electrónico separadas por comas para incluir en Cc
`from`	`String`	La dirección desde la que se debe enviar el correo electrónico, que debe ser uno de los valores que muestra `GmailApp.getAliases()`
`htmlBody`	`String`	Si 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.
`inlineImages`	`Object`	un 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" />`
`name`	`String`	el nombre del remitente del correo electrónico (configuración predeterminada: el nombre del usuario)
`replyTo`	`String`	una 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)

Devolvedor

GmailDraft: Es el borrador actualizado recientemente.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances o los permisos adecuados de la API de REST relacionada:

https://mail.google.com/

Consulta también

GmailApp.createDraft(recipient, subject, body, options)