Un archivo adjunto de Gmail Este es un Blob
normal, con la excepción de que tiene un método getSize()
adicional que es más rápido que llamar a getBytes()
.length
y no se descuenta de la cuota de lectura de Gmail.
// Logs information about any attachments in the first 100 inbox threads. var threads = GmailApp.getInboxThreads(0, 100); var msgs = GmailApp.getMessagesForThreads(threads); for (var i = 0 ; i < msgs.length; i++) { for (var j = 0; j < msgs[i].length; j++) { var attachments = msgs[i][j].getAttachments(); for (var k = 0; k < attachments.length; k++) { Logger.log('Message "%s" contains the attachment "%s" (%s bytes)', msgs[i][j].getSubject(), attachments[k].getName(), attachments[k].getSize()); } } }
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
copyBlob() | Blob | Muestra una copia de este BLOB. |
getAs(contentType) | Blob | Muestra los datos dentro de este objeto como un BLOB convertido al tipo de contenido especificado. |
getBytes() | Byte[] | Obtiene los datos almacenados en este BLOB. |
getContentType() | String | Obtiene el tipo de contenido de los bytes de este BLOB. |
getDataAsString() | String | Obtiene los datos de este BLOB como una string con codificación UTF-8. |
getDataAsString(charset) | String | Obtiene los datos de este BLOB como una string con la codificación especificada. |
getHash() | String | Obtiene el hash de contenido SHA1 para este archivo adjunto. |
getName() | String | Obtiene el nombre de este BLOB. |
getSize() | Integer | Obtiene el tamaño de este archivo adjunto. |
isGoogleType() | Boolean | Muestra si este BLOB es un archivo de Google Workspace (Hojas de cálculo, Documentos, etcétera). |
setBytes(data) | Blob | Configura los datos almacenados en este BLOB. |
setContentType(contentType) | Blob | Configura el tipo de contenido de los bytes en este BLOB. |
setContentTypeFromExtension() | Blob | Establece el tipo de contenido de los bytes en este BLOB según la extensión de archivo. |
setDataFromString(string) | Blob | Configura los datos de este BLOB a partir de una string con codificación UTF-8. |
setDataFromString(string, charset) | Blob | Configura los datos de este BLOB a partir de una string con la codificación especificada. |
setName(name) | Blob | Establece el nombre de este BLOB. |
Documentación detallada
copyBlob()
getAs(contentType)
Muestra los datos dentro de este objeto como un BLOB convertido al tipo de contenido especificado. Este método agrega la extensión adecuada al nombre de archivo, por ejemplo, “myfile.pdf”. Sin embargo, se supone que la parte del nombre de archivo que sigue al último punto (si existe) es una extensión existente que se debe reemplazar. En consecuencia, “ShoppingList.12.25.2014” se convierte en “ShoppingList.12.25.pdf”.
Para ver las cuotas diarias de las conversiones, consulta Cuotas de los servicios de Google. Los dominios de Google Workspace creados recientemente pueden estar sujetos a cuotas más estrictas de forma temporal.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
contentType | String | El tipo de MIME al que se realizará la conversión. Para la mayoría de los BLOB, 'application/pdf' es la única opción válida. En el caso de las imágenes en formato BMP, GIF, JPEG o PNG, también es válido cualquiera de los valores 'image/bmp' , 'image/gif' , 'image/jpeg' o 'image/png' . |
Devolvedor
Blob
: Son los datos como un BLOB.
getBytes()
Obtiene los datos almacenados en este BLOB.
Devolvedor
Byte[]
: Son los bytes almacenados.
getContentType()
Obtiene el tipo de contenido de los bytes de este BLOB.
Devolvedor
String
: Es el tipo de contenido de estos datos, si los conoce, o null
.
getDataAsString()
Obtiene los datos de este BLOB como una string con codificación UTF-8.
Devolvedor
String
: Son los datos como una string.
getDataAsString(charset)
Obtiene los datos de este BLOB como una string con la codificación especificada.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
charset | String | Es el charset que se usará para codificar los datos de este BLOB como una string. |
Devolvedor
String
: Son los datos como una string.
getHash()
Obtiene el hash de contenido SHA1 para este archivo adjunto. Este método no se descuenta de la cuota de lectura de Gmail.
Devolvedor
String
: Es el hash de contenido SHA1, como una cadena.
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/
getName()
Obtiene el nombre de este BLOB.
Devolvedor
String
: Es el nombre de estos datos, si los conoce, o null
.
getSize()
Obtiene el tamaño de este archivo adjunto. Este método es más rápido que llamar a getBytes()
.length
y no se descuenta de la cuota de lectura de Gmail.
Devolvedor
Integer
: Es el tamaño del adjunto, en bytes.
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/
isGoogleType()
Muestra si este BLOB es un archivo de Google Workspace (Hojas de cálculo, Documentos, etcétera).
Devolvedor
Boolean
: Es true
si este BLOB es un archivo de Google Workspace; false
si no es así.
setBytes(data)
Configura los datos almacenados en este BLOB.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
data | Byte[] | Los datos nuevos. |
Devolvedor
Blob
: Este BLOB para encadenamiento
setContentType(contentType)
Configura el tipo de contenido de los bytes en este BLOB.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
contentType | String | El nuevo contentType. |
Devolvedor
Blob
: Este BLOB para encadenamiento
setContentTypeFromExtension()
Establece el tipo de contenido de los bytes en este BLOB según la extensión de archivo. El contentType es null
si no se puede adivinar a partir de su extensión.
Devolvedor
Blob
: Este BLOB para encadenamiento
setDataFromString(string)
Configura los datos de este BLOB a partir de una string con codificación UTF-8.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
string | String | Los datos de la cadena. |
Devolvedor
Blob
: Este BLOB para encadenamiento
setDataFromString(string, charset)
Configura los datos de este BLOB a partir de una string con la codificación especificada.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
string | String | Los datos de la cadena. |
charset | String | El charset que se debe usar para interpretar la string como bytes. |
Devolvedor
Blob
: Este BLOB para encadenamiento
setName(name)
Establece el nombre de este BLOB.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
name | String | El nombre nuevo. |
Devolvedor
Blob
: Este BLOB para encadenamiento