Class GmailAttachment

Un allegato di Gmail. Si tratta di un normale Blob, tranne per il fatto che ha un metodo getSize() aggiuntivo 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 memorizzati in questo blob.
`getContentType()`	`String\|null`	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 SHA1 dei contenuti per questo allegato.
`getName()`	`String\|null`	Restituisce il nome di questo blob.
`getSize()`	`Integer`	Restituisce le dimensioni di questo allegato.
`isGoogleType()`	`Boolean`	Restituisce un valore che indica se questo blob è un file Google Workspace (Fogli, Documenti e così via).
`setBytes(data)`	`Blob`	Imposta i dati memorizzati 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 composito).

Documentazione dettagliata

`copyBlob()`

Restituisce una copia di questo blob.

Indietro

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, presuppone 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ù rigide.

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, sono validi anche `'image/bmp'`, `'image/gif'`, `'image/jpeg'` o `'image/png'`. Per un documento Google, è valido anche `'text/markdown'`.

Indietro

Blob: i dati come blob.

`getBytes()`

Recupera i dati memorizzati in questo blob.

Indietro

Byte[]: i byte archiviati.

`getContentType()`

Recupera il tipo di contenuto dei byte in questo blob.

Indietro

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

`getDataAsString()`

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

Indietro

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.

Indietro

String: i dati come stringa.

`getHash()`

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

Indietro

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

https://mail.google.com/

`getName()`

Restituisce il nome di questo blob.

Indietro

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

`getSize()`

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

Indietro

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 dell'API REST correlata:

https://mail.google.com/

`isGoogleType()`

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

Indietro

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

`setBytes(data)`

Imposta i dati memorizzati in questo blob.