Class GmailAttachment

Ein Anhang aus Gmail. Dies ist ein reguläres Blob, das jedoch eine zusätzliche getSize()-Methode hat, die schneller ist als der Aufruf von getBytes().length und nicht auf das Gmail-Lesekontingent angerechnet wird.

// 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(),
      );
    }
  }
}

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`copyBlob()`	`Blob`	Gibt eine Kopie dieses Blobs zurück.
`getAs(contentType)`	`Blob`	Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde.
`getBytes()`	`Byte[]`	Ruft die in diesem Blob gespeicherten Daten ab.
`getContentType()`	`String\|null`	Ruft den Inhaltstyp der Byte in diesem Blob ab.
`getDataAsString()`	`String`	Ruft die Daten dieses Blobs als String mit UTF-8-Codierung ab.
`getDataAsString(charset)`	`String`	Ruft die Daten dieses Blobs als String mit der angegebenen Codierung ab.
`getHash()`	`String`	Ruft den SHA1-Inhaltshash für diesen Anhang ab.
`getName()`	`String\|null`	Ruft den Namen dieses Blobs ab.
`getSize()`	`Integer`	Ruft die Größe dieses Anhangs ab.
`isGoogleType()`	`Boolean`	Gibt zurück, ob dieser Blob eine Google Workspace-Datei (Google Sheets, Google Docs usw.) ist.
`setBytes(data)`	`Blob`	Legt die in diesem Blob gespeicherten Daten fest.
`setContentType(contentType)`	`Blob`	Legt den Inhaltstyp der Byte in diesem Blob fest.
`setContentTypeFromExtension()`	`Blob`	Legt den Inhaltstyp der Byte in diesem Blob anhand der Dateiendung fest.
`setDataFromString(string)`	`Blob`	Legt die Daten dieses Blobs aus einem String mit UTF-8-Codierung fest.
`setDataFromString(string, charset)`	`Blob`	Legt die Daten dieses Blobs aus einem String mit der angegebenen Codierung fest.
`setName(name)`	`Blob`	Legt den Namen dieses Blobs fest.

Veraltete Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`getAllBlobs()`	`Blob[]`	Ruft alle Blobs ab, die in diesem (möglicherweise zusammengesetzten) Blob enthalten sind.

Detaillierte Dokumentation

`copyBlob()`

Gibt eine Kopie dieses Blobs zurück.

Rückgabe

Blob : Die neue Kopie.

`getAs(contentType)`

Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. Diese Methode fügt dem Dateinamen die entsprechende Erweiterung hinzu, z. B. „meinedatei.pdf“. Dabei wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der nach dem letzten Punkt folgt (falls vorhanden), eine vorhandene Erweiterung ist, die ersetzt werden soll. Folglich wird aus „Einkaufsliste.12.25.2014“ „Einkaufsliste.12.25.pdf“.

Die täglichen Kontingente für Conversions finden Sie unter Kontingente für Google Dienste. Für neu erstellte Google Workspace-Domains gelten möglicherweise vorübergehend strengere Kontingente.

Parameter

Name	Typ	Beschreibung
`contentType`	`String`	Der MIME-Typ, in den konvertiert werden soll. Für die meisten Blobs ist `'application/pdf'` die einzige gültige Option. Für Bilder im BMP-, GIF-, JPEG- oder PNG-Format sind auch `'image/bmp'`, `'image/gif'`, `'image/jpeg'` oder `'image/png'` gültig. Für ein Google Docs-Dokument ist auch `'text/markdown'` gültig.

Rückgabe

Blob : Die Daten als Blob.

`getBytes()`

Ruft die in diesem Blob gespeicherten Daten ab.

Rückgabe

Byte[] : Die gespeicherten Byte.

`getContentType()`

Ruft den Inhaltstyp der Byte in diesem Blob ab.

Rückgabe

String|null : Der Inhaltstyp dieser Daten, falls bekannt, oder null.

`getDataAsString()`

Ruft die Daten dieses Blobs als String mit UTF-8-Codierung ab.

Rückgabe

String : Die Daten als String.

`getDataAsString(charset)`

Ruft die Daten dieses Blobs als String mit der angegebenen Codierung ab.

Parameter

Name	Typ	Beschreibung
`charset`	`String`	Der Zeichensatz, der zum Codieren der Daten in diesem Blob als String verwendet werden soll.

Rückgabe

String : Die Daten als String.

`getHash()`

Ruft den SHA1-Inhaltshash für diesen Anhang ab. Diese Methode wird nicht auf das Gmail-Lesekontingent angerechnet.

Rückgabe

String : Der SHA1-Inhaltshash als String.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung mit mindestens einem der folgenden Zugriffsbereiche oder entsprechenden Zugriffsbereichen aus der zugehörigen REST API erforderlich:

https://mail.google.com/

`getName()`

Ruft den Namen dieses Blobs ab.

Rückgabe

String|null : Der Name dieser Daten, falls bekannt, oder null.

`getSize()`

Ruft die Größe dieses Anhangs ab. Diese Methode ist schneller als der Aufruf von getBytes().length und wird nicht auf das Gmail-Lesekontingent angerechnet.

Rückgabe

Integer : Die Größe des Anhangs in Byte.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung mit mindestens einem der folgenden Zugriffsbereiche oder entsprechenden Zugriffsbereichen aus der zugehörigen REST API erforderlich:

https://mail.google.com/

`isGoogleType()`

Gibt zurück, ob dieser Blob eine Google Workspace-Datei (Google Sheets, Google Docs usw.) ist.

Rückgabe

Boolean : true, wenn dieser Blob eine Google Workspace-Datei ist, andernfalls false.

`setBytes(data)`

Legt die in diesem Blob gespeicherten Daten fest.