Un allegato da Gmail. Si tratta di una Blob
normale, tranne per il fatto che ha un metodo getSize()
aggiuntivo che è più veloce rispetto alla chiamata
getBytes()
.length
e non incide sulla quota di lettura di 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()); } } }
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
copyBlob() | Blob | Restituisce una copia del blob. |
getAs(contentType) | Blob | Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato. |
getBytes() | Byte[] | Recupera i dati archiviati in questo blob. |
getContentType() | String | Ottiene il tipo di contenuto dei byte in questo blob. |
getDataAsString() | String | Recupera i dati di questo blob come stringa con codifica UTF-8. |
getDataAsString(charset) | String | Restituisce i dati di questo blob come stringa con la codifica specificata. |
getHash() | String | Ottiene l'hash dei contenuti SHA1 per questo allegato. |
getName() | String | Ottiene il nome del blob. |
getSize() | Integer | Recupera le dimensioni di questo allegato. |
isGoogleType() | Boolean | Indica se il blob è un file di Google Workspace (Fogli, Documenti e così via). |
setBytes(data) | Blob | Imposta i dati archiviati in questo blob. |
setContentType(contentType) | Blob | Imposta il tipo di contenuto dei byte in questo blob. |
setContentTypeFromExtension() | Blob | Imposta il tipo di contenuto dei byte in questo blob in base all'estensione del file. |
setDataFromString(string) | Blob | Imposta i dati di questo blob da una stringa con codifica UTF-8. |
setDataFromString(string, charset) | Blob | Imposta i dati di questo blob da una stringa con la codifica specificata. |
setName(name) | Blob | Imposta il nome del blob. |
Documentazione dettagliata
copyBlob()
getAs(contentType)
Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato. Questo aggiunge l'estensione appropriata al nome del file, ad esempio "miofile.pdf". Tuttavia, presuppone che la parte del nome file che segue l'ultimo punto (se presente) sia una un'estensione che deve essere sostituita. Di conseguenza, "ShoppingList.25.12.2014" diventa "ShoppingList.12.25.pdf".
Per visualizzare le quote giornaliere per le conversioni, consulta Quote per Google Servizi. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a restrizioni quote.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
contentType | String | Il tipo MIME in cui eseguire la conversione. Per la maggior parte dei blob, 'application/pdf' è
è l'unica opzione valida. Per le immagini in formato BMP, GIF, JPEG o PNG, vengono visualizzati anche i valori 'image/bmp' , 'image/gif' , 'image/jpeg' o 'image/png'
valida. Per un documento di Documenti Google è valido anche 'text/markdown' . |
Invio
Blob
: i dati come blob.
getBytes()
Recupera i dati archiviati in questo blob.
Invio
Byte[]
: i byte archiviati.
getContentType()
Ottiene il tipo di contenuto dei byte in questo blob.
Invio
String
: il tipo di contenuti di questi dati, se noto, o null
.
getDataAsString()
Recupera i dati di questo blob come stringa con codifica UTF-8.
Invio
String
: i dati come stringa.
getDataAsString(charset)
Restituisce i dati di questo blob come stringa con la codifica specificata.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
charset | String | Il set di caratteri da utilizzare per la codifica dei dati in questo blob come stringa. |
Invio
String
: i dati come stringa.
getHash()
Ottiene l'hash dei contenuti SHA1 per questo allegato. Questo metodo non viene conteggiato ai fini del calcolo di Gmail di lettura.
Invio
String
: l'hash dei contenuti SHA1 come stringa.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti oppure ambiti appropriati dell'API REST correlata:
-
https://mail.google.com/
getName()
Ottiene il nome del blob.
Invio
String
: il nome di questi dati, se noto, o null
.
getSize()
Recupera le dimensioni di questo allegato. Questo metodo è più veloce rispetto alla chiamata a getBytes()
.length
e non viene conteggiato ai fini del calcolo della quota di lettura di Gmail.
Invio
Integer
: le dimensioni dell'allegato in byte.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti oppure ambiti appropriati dell'API REST correlata:
-
https://mail.google.com/
isGoogleType()
Indica se il blob è un file di Google Workspace (Fogli, Documenti e così via).
Invio
Boolean
- true
se il blob è un file di Google Workspace; false
in caso contrario.
setBytes(data)
Imposta i dati archiviati in questo blob.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
data | Byte[] | I nuovi dati. |
Invio
Blob
: questo blob, per il concatenamento.
setContentType(contentType)
Imposta il tipo di contenuto dei byte in questo blob.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
contentType | String | Il nuovo contentType. |
Invio
Blob
: questo blob, per il concatenamento.
setContentTypeFromExtension()
Imposta il tipo di contenuto dei byte in questo blob in base all'estensione del file. Il valore ContentType è
null
se non può essere intuito dalla sua estensione.
Invio
Blob
: questo blob, per il concatenamento.
setDataFromString(string)
Imposta i dati di questo blob da una stringa con codifica UTF-8.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
string | String | I dati stringa. |
Invio
Blob
: questo blob, per il concatenamento.
setDataFromString(string, charset)
Imposta i dati di questo blob da una stringa con la codifica specificata.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
string | String | I dati stringa. |
charset | String | Il set di caratteri da utilizzare per interpretare la stringa come byte. |
Invio
Blob
: questo blob, per il concatenamento.
setName(name)
Imposta il nome del blob.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nuovo nome. |
Invio
Blob
: questo blob, per il concatenamento.