Un borrador de mensaje creado por el usuario en su cuenta de Gmail.
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
deleteDraft() | void | Elimina este borrador de 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 este borrador. |
send() | GmailMessage | Envía este borrador de mensaje 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 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
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 |
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
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 agregar en Cc |
from | String | la dirección desde la que se debe enviar el correo electrónico, que debe ser una
de los valores que muestra GmailApp.getAliases() |
htmlBody | String | Si 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 |
inlineImages | Object | un 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" /> |
name | String | el nombre del remitente del correo electrónico (predeterminado: el nombre del usuario) |
replyTo | String | una 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/