Diese Seite wurde von der Cloud Translation API übersetzt.

Class GmailAttachment

Anhang aus Gmail Dies ist eine normale Blob, mit der Ausnahme, dass sie eine zusätzliche getSize()-Methode hat, die schneller ist als der Aufruf von getBytes().length und nicht auf das Lesekontingent von Gmail 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, der in den angegebenen Inhaltstyp konvertiert wurde.
`getBytes()`	`Byte[]`	Ruft die in diesem Blob gespeicherten Daten ab.
`getContentType()`	`String`	Der Inhaltstyp der Bytes in diesem Blob.
`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-Inhalts-Hash für diesen Anhang ab.
`getName()`	`String`	Ruft den Namen dieses Blobs ab.
`getSize()`	`Integer`	Ruft die Größe dieses Anhangs ab.
`isGoogleType()`	`Boolean`	Gibt an, ob es sich bei diesem Blob um eine Google Workspace-Datei (z. B. Google Tabellen oder Google Docs) handelt.
`setBytes(data)`	`Blob`	Legt die in diesem Blob gespeicherten Daten fest.
`setContentType(contentType)`	`Blob`	Legt den Inhaltstyp der Bytes in diesem Blob fest.
`setContentTypeFromExtension()`	`Blob`	Legt den Inhaltstyp der Bytes in diesem Blob basierend auf der Dateiendung fest.
`setDataFromString(string)`	`Blob`	Die Daten dieses Blobs werden aus einem String mit UTF-8-Codierung festgelegt.
`setDataFromString(string, charset)`	`Blob`	Die Daten dieses Blobs werden aus einem String mit der angegebenen Codierung festgelegt.
`setName(name)`	`Blob`	Legt den Namen dieses Blobs fest.

Eingestellte Methoden

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

Detaillierte Dokumentation

`copyBlob()`

Gibt eine Kopie dieses Blobs zurück.

Rückflug

Blob – die neue Kopie.

`getAs(contentType)`

Gibt die Daten in diesem Objekt als Blob zurück, der in den angegebenen Inhaltstyp konvertiert wurde. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. „meinedatei.pdf“. Es wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt (falls vorhanden) folgt, eine vorhandene Erweiterung ist, die ersetzt werden soll. Daraus wird „Einkaufsliste.25.12.2014“ zu „Einkaufsliste.25.12.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. Bei Bildern im BMP-, GIF-, JPEG- oder PNG-Format sind auch `'image/bmp'`, `'image/gif'`, `'image/jpeg'` oder `'image/png'` zulässig. Für ein Google Docs-Dokument ist auch `'text/markdown'` zulässig.

Rückflug

Blob – Die Daten als Blob.

`getBytes()`

Ruft die in diesem Blob gespeicherten Daten ab.

Rückflug

Byte[]: Die gespeicherten Byte.

`getContentType()`

Der Inhaltstyp der Bytes in diesem Blob.

Rückflug

String: Der Inhaltstyp dieser Daten, sofern bekannt, oder null.

`getDataAsString()`

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

Rückflug

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`	Die Zeichencodierung, die zum Codieren der Daten in diesem Blob als String verwendet werden soll.

Rückflug

String: Die Daten als String.

`getHash()`

Ruft den SHA1-Inhalts-Hash für diesen Anhang ab. Diese Methode wird nicht auf das Leselimit in Gmail angerechnet.

Rückflug

String: Der SHA1-Inhalts-Hash als String.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

https://mail.google.com/

`getName()`

Ruft den Namen dieses Blobs ab.

Rückflug

String: Der Name dieser Daten, sofern 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 Lesekontingent in Gmail angerechnet.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

https://mail.google.com/

`isGoogleType()`

Gibt an, ob es sich bei diesem Blob um eine Google Workspace-Datei (z. B. Google Tabellen oder Google Docs) handelt.

Rückflug

Boolean – true, wenn es sich bei diesem Blob um eine Google Workspace-Datei handelt, false andernfalls.

`setBytes(data)`

Legt die in diesem Blob gespeicherten Daten fest.