Questa pagina è stata tradotta dall'API Cloud Translation.

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

Metodi deprecati

Metodo	Tipo restituito	Breve descrizione
`getAllBlobs()`	`Blob[]`	Ottiene tutti i blob contenuti all'interno del blob (possibilmente composito).

Documentazione dettagliata

`copyBlob()`

Restituisce una copia del blob.

Invio

Blob: la nuova copia.

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