Class GmailAttachment

GmailAttachment

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 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étodoTipo de datos que se muestraDescripción breve
copyBlob()BlobMuestra una copia de este BLOB.
getAs(contentType)BlobMuestra 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()StringObtiene el tipo de contenido de los bytes en este BLOB.
getDataAsString()StringObtiene los datos de este BLOB como una cadena con codificación UTF-8.
getDataAsString(charset)StringObtiene los datos de este BLOB como una string con la codificación especificada.
getHash()StringObtiene el hash del contenido SHA1 para este archivo adjunto.
getName()StringObtiene el nombre de este BLOB.
getSize()IntegerObtiene el tamaño de este archivo adjunto.
isGoogleType()BooleanMuestra si este BLOB es un archivo de Google Workspace (Hojas de cálculo, Documentos, etc.).
setBytes(data)BlobConfigura los datos almacenados en este BLOB.
setContentType(contentType)BlobConfigura el tipo de contenido de los bytes en este BLOB.
setContentTypeFromExtension()BlobConfigura el tipo de contenido de los bytes en este BLOB según la extensión del archivo.
setDataFromString(string)BlobConfigura los datos de este BLOB a partir de una string con codificación UTF-8.
setDataFromString(string, charset)BlobEstablece los datos de este BLOB a partir de una string con la codificación especificada.
setName(name)BlobEstablece el nombre de este BLOB.

Documentación detallada

copyBlob()

Muestra una copia de este BLOB.

Volver

Blob: Es la copia nueva.


getAs(contentType)

Muestra los datos dentro de este objeto como un BLOB convertido al tipo de contenido especificado. Esta agrega la extensión adecuada al nombre del archivo, por ejemplo, "miarchivo.pdf". Sin embargo, supone que la parte del nombre de archivo que sigue al último punto (si corresponde) es una parte extensión que debe reemplazarse. Por lo tanto, "ShoppingList.12.25.2014" se convierte en “ShoppingList.12.25.pdf”.

Para ver las cuotas diarias de las conversiones, consulta Cuotas para Google Servicios Es posible que los dominios de Google Workspace recién creados estén sujetos temporalmente a restricciones y cuotas.

Parámetros

NombreTipoDescripción
contentTypeStringEl tipo de MIME en el que se convertirá. 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 se aplica cualquiera de los siguientes valores: 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'. válido. 'text/markdown' también es válido para Documentos de Google.

Volver

Blob: Los datos como un BLOB.


getBytes()

Obtiene los datos almacenados en este BLOB.

Volver

Byte[]: son los bytes almacenados.


getContentType()

Obtiene el tipo de contenido de los bytes en este BLOB.

Volver

String: Es el tipo de contenido de estos datos, si se conocen, o null.


getDataAsString()

Obtiene los datos de este BLOB como una cadena con codificación UTF-8.

Volver

String: los datos como una cadena.


getDataAsString(charset)

Obtiene los datos de este BLOB como una string con la codificación especificada.

Parámetros

NombreTipoDescripción
charsetStringEl charset que se usará para codificar los datos en este BLOB como una cadena.

Volver

String: los datos como una cadena.


getHash()

Obtiene el hash del contenido SHA1 para este archivo adjunto. Este método no se descuenta de la cuenta de Gmail de lectura.

Volver

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.

Volver

String: Es el nombre de estos datos, si se conocen, 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.

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

Volver

Boolean: 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

NombreTipoDescripción
dataByte[]Los datos nuevos.

Volver

Blob: Este BLOB, para el encadenamiento.


setContentType(contentType)

Configura el tipo de contenido de los bytes en este BLOB.

Parámetros

NombreTipoDescripción
contentTypeStringEs el nuevo contentType.

Volver

Blob: Este BLOB, para el encadenamiento.


setContentTypeFromExtension()

Configura el tipo de contenido de los bytes en este BLOB según la extensión del archivo. El contentType es null si no se puede adivinar a partir de su extensión.

Volver

Blob: Este BLOB, para el encadenamiento.


setDataFromString(string)

Configura los datos de este BLOB a partir de una string con codificación UTF-8.

Parámetros

NombreTipoDescripción
stringStringLos datos de la cadena.

Volver

Blob: Este BLOB, para el encadenamiento.


setDataFromString(string, charset)

Establece los datos de este BLOB a partir de una string con la codificación especificada.

Parámetros

NombreTipoDescripción
stringStringLos datos de la cadena.
charsetStringConjunto de caracteres que se usará para interpretar la string como bytes.

Volver

Blob: Este BLOB, para el encadenamiento.


setName(name)

Establece el nombre de este BLOB.

Parámetros

NombreTipoDescripción
nameStringEl nombre nuevo.

Volver

Blob: Este BLOB, para el encadenamiento.

Métodos obsoletos