Class GmailAttachment

GmailAttachment

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 viene conteggiato ai fini del calcolo della 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

MetodoTipo restituitoBreve descrizione
copyBlob()BlobRestituisce una copia di questo blob.
getAs(contentType)BlobRestituisce i dati all'interno di questo oggetto sotto forma di blob convertito nel tipo di contenuto specificato.
getBytes()Byte[]Consente di recuperare i dati archiviati in questo blob.
getContentType()StringRestituisce il tipo di contenuto dei byte in questo blob.
getDataAsString()StringRestituisce i dati di questo blob sotto forma di stringa con codifica UTF-8.
getDataAsString(charset)StringRestituisce i dati di questo blob sotto forma di stringa con la codifica specificata.
getHash()StringRestituisce l'hash dei contenuti SHA1 per questo allegato.
getName()StringRestituisce il nome del blob.
getSize()IntegerConsente di acquisire le dimensioni di questo allegato.
isGoogleType()BooleanIndica se il blob è un file di Google Workspace (Fogli, Documenti e così via).
setBytes(data)BlobImposta i dati archiviati in questo blob.
setContentType(contentType)BlobImposta il tipo di contenuti dei byte in questo blob.
setContentTypeFromExtension()BlobImposta il tipo di contenuto dei byte in questo blob in base all'estensione del file.
setDataFromString(string)BlobImposta i dati di questo blob da una stringa con codifica UTF-8.
setDataFromString(string, charset)BlobImposta i dati di questo blob da una stringa con la codifica specificata.
setName(name)BlobImposta il nome del blob.

Documentazione dettagliata

copyBlob()

Restituisce una copia di questo blob.

Ritorni

Blob: la nuova copia.


getAs(contentType)

Restituisce i dati all'interno di questo oggetto sotto forma di blob convertito nel tipo di contenuto specificato. Questo metodo aggiunge l'estensione appropriata al nome del file, ad esempio "myfile.pdf". Tuttavia, si presuppone che la parte del nome del file che segue l'ultimo punto (se presente) sia un'estensione esistente che deve essere sostituita. Di conseguenza, "ShoppingList.12.25.2014" diventa "ShoppingList.12.25.pdf".

Per visualizzare le quote giornaliere per le conversioni, consulta Quote per i servizi Google. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a quote più severe.

Parametri

NomeTipoDescrizione
contentTypeStringIl 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, è valido anche qualsiasi formato 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'.

Ritorni

Blob: i dati sotto forma di blob.


getBytes()

Consente di recuperare i dati archiviati in questo blob.

Ritorni

Byte[]: byte archiviati.


getContentType()

Restituisce il tipo di contenuto dei byte in questo blob.

Ritorni

String: il tipo di contenuti di questi dati, se noto, o null.


getDataAsString()

Restituisce i dati di questo blob sotto forma di stringa con codifica UTF-8.

Ritorni

String: i dati sotto forma di stringa.


getDataAsString(charset)

Restituisce i dati di questo blob sotto forma di stringa con la codifica specificata.

Parametri

NomeTipoDescrizione
charsetStringIl set di caratteri da utilizzare per la codifica dei dati in questo blob come stringa.

Ritorni

String: i dati sotto forma di stringa.


getHash()

Restituisce l'hash dei contenuti SHA1 per questo allegato. Questo metodo non viene conteggiato ai fini della quota di lettura di Gmail.

Ritorni

String: l'hash dei contenuti SHA1, sotto forma di stringa.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:

  • https://mail.google.com/

getName()

Restituisce il nome del blob.

Ritorni

String: il nome di questi dati, se noto, oppure null.


getSize()

Consente di acquisire le dimensioni di questo allegato. Questo metodo è più veloce rispetto alla chiamata al numero getBytes().length e non viene conteggiato ai fini del calcolo della quota di lettura di Gmail.

Ritorni

Integer: le dimensioni dell'allegato in byte.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:

  • https://mail.google.com/

isGoogleType()

Indica se il blob è un file di Google Workspace (Fogli, Documenti e così via).

Ritorni

Boolean: true se il blob è un file di Google Workspace; false in caso contrario.


setBytes(data)

Imposta i dati archiviati in questo blob.

Parametri

NomeTipoDescrizione
dataByte[]I nuovi dati.

Ritorni

Blob - Questo blob, per il concatenamento.


setContentType(contentType)

Imposta il tipo di contenuti dei byte in questo blob.

Parametri

NomeTipoDescrizione
contentTypeStringIl nuovo contentType.

Ritorni

Blob - Questo blob, per il concatenamento.


setContentTypeFromExtension()

Imposta il tipo di contenuto dei byte in questo blob in base all'estensione del file. Il contentType è null se non può essere intuito dalla sua estensione.

Ritorni

Blob - Questo blob, per il concatenamento.


setDataFromString(string)

Imposta i dati di questo blob da una stringa con codifica UTF-8.

Parametri

NomeTipoDescrizione
stringStringI dati della stringa.

Ritorni

Blob - Questo blob, per il concatenamento.


setDataFromString(string, charset)

Imposta i dati di questo blob da una stringa con la codifica specificata.

Parametri

NomeTipoDescrizione
stringStringI dati della stringa.
charsetStringIl set di caratteri da utilizzare per interpretare la stringa come byte.

Ritorni

Blob - Questo blob, per il concatenamento.


setName(name)

Imposta il nome del blob.

Parametri

NomeTipoDescrizione
nameStringIl nuovo nome.

Ritorni

Blob - Questo blob, per il concatenamento.

Metodi deprecati