Class GmailAttachment

Allegato Gmail

Un allegato di Gmail. Si tratta di una modalità Blob standard, tranne per il fatto che ha un metodo getSize() aggiuntivo più veloce di quello delle chiamate getBytes().length e non viene conteggiato nella 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 come un blob convertito nel tipo di contenuto specificato.
getBytes()Byte[]Recupera i dati archiviati in questo blob.
getContentType()StringRestituisce il tipo di contenuti dei byte in questo blob.
getDataAsString()StringRecupera i dati di questo blob come stringa con codifica UTF-8.
getDataAsString(charset)StringVisualizza i dati di questo blob come stringa con la codifica specificata.
getHash()StringRecupera l'hash del contenuto SHA1 per questo allegato.
getName()StringRecupera il nome di questo blob.
getSize()IntegerVisualizza le dimensioni dell'allegato.
isGoogleType()BooleanRestituisce se questo 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 contenuto 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 di questo blob.

Documentazione dettagliata

copyBlob()

Restituisce una copia di questo blob.

Andata e ritorno

Blob: la nuova copia.


getAs(contentType)

Restituisce i dati all'interno di questo oggetto come un blob convertito nel tipo di contenuto specificato. Questo metodo aggiunge l'estensione appropriata al nome file, ad esempio "myfile.pdf". Tuttavia, si suppone che la parte del nome 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 servizi Google. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a quote più rigide.

Parametri

NomeTipoDescrizione
contentTypeStringIl tipo MIME in cui effettuare la conversione. Per la maggior parte dei blob, 'application/pdf' è l'unica opzione valida. Per le immagini in formato BMP, GIF, JPEG o PNG, sono validi anche tutti i formati 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'.

Andata e ritorno

Blob: i dati sotto forma di blob.


getBytes()

Recupera i dati archiviati in questo blob.

Andata e ritorno

Byte[]: i byte memorizzati.


getContentType()

Restituisce il tipo di contenuti dei byte in questo blob.

Andata e ritorno

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


getDataAsString()

Recupera i dati di questo blob come stringa con codifica UTF-8.

Andata e ritorno

String: i dati sotto forma di stringa.


getDataAsString(charset)

Visualizza i dati di questo blob come stringa con la codifica specificata.

Parametri

NomeTipoDescrizione
charsetStringIl set di caratteri da utilizzare per codificare i dati in questo blob come stringa.

Andata e ritorno

String: i dati sotto forma di stringa.


getHash()

Recupera l'hash del contenuto SHA1 per questo allegato. Questo metodo non viene conteggiato nella quota di lettura di Gmail.

Andata e ritorno

String: l'hash del contenuto SHA1, come stringa.

Autorizzazione

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

  • https://mail.google.com/

getName()

Recupera il nome di questo blob.

Andata e ritorno

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


getSize()

Visualizza le dimensioni dell'allegato. Questo metodo è più veloce di chiamare getBytes().length e non incide sulla quota di lettura di Gmail.

Andata e ritorno

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 con gli ambiti appropriati dell'API REST correlata:

  • https://mail.google.com/

isGoogleType()

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

Andata e ritorno

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


setBytes(data)

Imposta i dati archiviati in questo blob.

Parametri

NomeTipoDescrizione
dataByte[]I nuovi dati.

Andata e ritorno

Blob: questo blob per il concatenamento.


setContentType(contentType)

Imposta il tipo di contenuto dei byte in questo blob.

Parametri

NomeTipoDescrizione
contentTypeStringIl nuovo contentType.

Andata e ritorno

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 di ContentType è null se non è possibile indovinarlo dalla relativa estensione.

Andata e ritorno

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.

Andata e ritorno

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.

Andata e ritorno

Blob: questo blob per il concatenamento.


setName(name)

Imposta il nome di questo blob.

Parametri

NomeTipoDescrizione
nameStringIl nuovo nome.

Andata e ritorno

Blob: questo blob per il concatenamento.

Metodi deprecati