Questa pagina è stata tradotta dall'API Cloud Translation.

Class GmailAttachment

Un allegato di Gmail. Si tratta di un normale Blob, tranne per il fatto che ha un metodo getSize() aggiuntivo che è più veloce della chiamata getBytes().length e non viene conteggiato ai fini della quota di lettura di Gmail.

// Logs information about any attachments in the first 100 inbox threads.
const threads = GmailApp.getInboxThreads(0, 100);
const msgs = GmailApp.getMessagesForThreads(threads);
for (let i = 0; i < msgs.length; i++) {
  for (let j = 0; j < msgs[i].length; j++) {
    const attachments = msgs[i][j].getAttachments();
    for (let 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 di questo blob.
`getAs(contentType)`	`Blob`	Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato.
`getBytes()`	`Byte[]`	Recupera i dati archiviati in questo blob.
`getContentType()`	`String`	Recupera 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`	Recupera i dati di questo blob come stringa con la codifica specificata.
`getHash()`	`String`	Recupera l'hash dei contenuti SHA1 per questo allegato.
`getName()`	`String`	Recupera il nome di questo blob.
`getSize()`	`Integer`	Recupera le dimensioni di questo allegato.
`isGoogleType()`	`Boolean`	Restituisce se questo 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 contenuti dei byte in questo blob.
`setContentTypeFromExtension()`	`Blob`	Imposta il tipo di contenuti 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 di questo blob.

Metodi ritirati

Metodo	Tipo restituito	Breve descrizione
`getAllBlobs()`	`Blob[]`	Recupera tutti i blob contenuti in questo blob (eventualmente composto).

Documentazione dettagliata

`copyBlob()`

Restituisce una copia di questo blob.

Invio

Blob: la nuova copia.

`getAs(contentType)`

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

Parametri

Nome	Tipo	Descrizione
`contentType`	`String`	Il tipo MIME a 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, sono validi anche `'image/bmp'`, `'image/gif'`, `'image/jpeg'` o `'image/png'`. 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()`

Recupera 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)`

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

Parametri

Nome	Tipo	Descrizione
`charset`	`String`	Il set di caratteri da utilizzare per codificare i dati in questo blob come stringa.

Invio

String: i dati come stringa.

`getHash()`

Recupera l'hash dei contenuti SHA1 per questo allegato. Questo metodo non incide sulla quota di messaggiletti di Gmail.

Invio

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

https://mail.google.com/

`getName()`

Recupera il nome di questo blob.

Invio

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

`getSize()`

Recupera le dimensioni di questo allegato. Questo metodo è più veloce della chiamata a getBytes().length e non viene conteggiato ai fini della quota di lettura di Gmail.

Invio

Integer: le dimensioni dell'allegato, espresse 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).

Invio

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

`setBytes(data)`

Imposta i dati archiviati in questo blob.