Class GmailDraft

GmailDraft

Un borrador de mensaje creado por el usuario en su cuenta de Gmail.

Métodos

MétodoTipo de datos que se muestraDescripción breve
deleteDraft()voidElimina este borrador de mensaje.
getId()StringObtiene el ID de este borrador de mensaje.
getMessage()GmailMessageMuestra un GmailMessage que representa este borrador.
getMessageId()StringMuestra el ID de la GmailMessage que representa este borrador.
send()GmailMessageEnvía este borrador de mensaje de correo electrónico.
update(recipient, subject, body)GmailDraftReemplaza el contenido de este borrador de mensaje.
update(recipient, subject, body, options)GmailDraftReemplaza el contenido de este borrador de mensaje con argumentos opcionales.

Documentación detallada

deleteDraft()

Elimina este borrador de 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());

Volver

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());

Volver

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 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());

Volver

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()

Envía este borrador de mensaje 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

Volver

GmailMessage: Es el mensaje recién enviado.

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

NombreTipoDescripción
recipientStringlista de direcciones de correo electrónico separadas por comas
subjectStringasunto del correo electrónico (250 caracteres como máximo)
bodyStringcuerpo del correo electrónico

Volver

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


update(recipient, subject, body, options)

Reemplaza el contenido de este borrador de mensaje con argumentos opcionales. El correo electrónico puede incluir 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

NombreTipoDescripción
recipientStringlista de direcciones de correo electrónico separadas por comas
subjectStringasunto del correo electrónico (250 caracteres como máximo)
bodyStringcuerpo 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
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
fromStringla dirección desde la que se debe enviar el correo electrónico, que debe ser una de los valores que muestra GmailApp.getAliases()
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)
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)

Volver

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