Un archivo adjunto de Gmail. Este es un Blob
normal, excepto 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 adjunto. |
getName() | String | Obtiene el nombre de este BLOB. |
getSize() | Integer | Obtiene el tamaño de este adjunto. |
isGoogleType() | Boolean | Muestra si este BLOB es un archivo de Google Workspace (Hojas de cálculo, Documentos, etcétera). |
setBytes(data) | Blob | Establece los datos almacenados en este BLOB. |
setContentType(contentType) | Blob | Establece el tipo de contenido de los bytes en este BLOB. |
setContentTypeFromExtension() | Blob | Establece el tipo de contenido de los bytes de este BLOB en función de la extensión de archivo. |
setDataFromString(string) | Blob | Establece los datos de este BLOB en una string con codificación UTF-8. |
setDataFromString(string, charset) | Blob | Configura los datos de este BLOB desde 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 del archivo, por ejemplo, &myt.myfile.pdf". Sin embargo, se supone que la parte del nombre de archivo que sigue al último período (si existe) es una extensión existente que se debe reemplazar. En consecuencia, "ShoppingList.15.15.2014" pasa a ser "ShoppingList.12.25.pdf".
Si quieres ver las cuotas diarias para conversiones, consulta Cuotas para servicios de Google. Es posible que los dominios de Google Workspace recién creados estén sujetos a cuotas más estrictas.
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. Para imágenes en formato BMP, GIF, JPEG o PNG, también son válidos 'image/bmp' , 'image/gif' , 'image/jpeg' o 'image/png' . |
Volver
Blob
: los datos como un BLOB
getBytes()
Obtiene los datos almacenados en este BLOB.
Volver
Byte[]
: los bytes almacenados.
getContentType()
Obtiene el tipo de contenido de los bytes de este BLOB.
Volver
String
: Es el tipo de contenido de estos datos, si se conoce, o null
.
getDataAsString()
Obtiene los datos de este BLOB como una string con codificación UTF-8.
Volver
String
: 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 | El charset que se usará para codificar los datos de este BLOB como una string. |
Volver
String
: los datos como una string
getHash()
Obtiene el hash de contenido SHA1 para este adjunto. Este método no cuenta para la cuota de lectura de Gmail.
Volver
String
: Es el hash de contenido SHA1, como una string.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances o alcances adecuados de la API de REST relacionada:
-
https://mail.google.com/
getName()
Obtiene el nombre de este BLOB.
Volver
String
: Es el nombre de estos datos, si se conocen, o null
.
getSize()
Obtiene el tamaño de este 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.
Volver
Integer
: 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 alcances 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).
Volver
Boolean
: true
si este BLOB es un archivo de Google Workspace; false
si no es así
setBytes(data)
Establece los datos almacenados en este BLOB.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
data | Byte[] | Los datos nuevos. |
Volver
Blob
: este BLOB para encadenar.
setContentType(contentType)
Establece el tipo de contenido de los bytes en este BLOB.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
contentType | String | El nuevo contentType. |
Volver
Blob
: este BLOB para encadenar.
setContentTypeFromExtension()
Establece el tipo de contenido de los bytes de este BLOB en función de la extensión de archivo. El contentType es null
si no se puede adivinar de su extensión.
Volver
Blob
: este BLOB para encadenar.
setDataFromString(string)
Establece los datos de este BLOB en una string con codificación UTF-8.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
string | String | Los datos de string. |
Volver
Blob
: este BLOB para encadenar.
setDataFromString(string, charset)
Configura los datos de este BLOB desde una string con la codificación especificada.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
string | String | Los datos de string. |
charset | String | El charset que se usará para interpretar la string como bytes. |
Volver
Blob
: este BLOB para encadenar.
setName(name)
Establece el nombre de este BLOB.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
name | String | El nombre nuevo. |
Volver
Blob
: este BLOB para encadenar.