Class GmailAttachment

GmailAttachment

Einen Anhang aus Gmail. Dies ist ein reguläres Blob, mit dem Unterschied, dass es eine zusätzliche getSize()-Methode enthält, die schneller ist als das Aufrufen von getBytes().length und wird nicht auf das Gmail-Lesekontingent angerechnet.

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

Methoden

MethodeRückgabetypKurzbeschreibung
copyBlob()BlobGibt eine Kopie dieses Blobs zurück.
getAs(contentType)BlobGibt 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()StringRuft den Inhaltstyp der Byte in diesem Blob ab.
getDataAsString()StringRuft die Daten dieses Blobs als String mit UTF-8-Codierung ab.
getDataAsString(charset)StringRuft die Daten dieses Blobs als String mit der angegebenen Codierung ab.
getHash()StringRuft den SHA1-Inhalts-Hash für diesen Anhang ab.
getName()StringRuft den Namen dieses Blobs ab.
getSize()IntegerRuft die Größe dieses Anhangs ab.
isGoogleType()BooleanGibt an, ob dieses Blob eine Google Workspace-Datei ist (z. B. Google Tabellen oder Google Docs).
setBytes(data)BlobLegt die in diesem Blob gespeicherten Daten fest.
setContentType(contentType)BlobLegt den Inhaltstyp der Byte in diesem Blob fest.
setContentTypeFromExtension()BlobLegt den Inhaltstyp der Byte in diesem Blob basierend auf der Dateiendung fest.
setDataFromString(string)BlobLegt die Daten dieses Blobs aus einem String mit UTF-8-Codierung fest.
setDataFromString(string, charset)BlobLegt die Daten dieses Blobs aus einem String mit der angegebenen Codierung fest.
setName(name)BlobLegt den Namen dieses Blobs fest.

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, das in den angegebenen Inhaltstyp konvertiert wurde. Dieses fügt dem Dateinamen die entsprechende Erweiterung hinzu, beispielsweise "meinedatei.pdf". Allerdings geht davon aus, dass der Teil des Dateinamens, der auf den letzten Punkt folgt (falls vorhanden), ein vorhandener die ersetzt werden soll. Daher lautet „Einkaufsliste.12.25.2014“. wird zu „Einkaufsliste.12.25.pdf“.

Die Tageskontingente für Conversions finden Sie unter Kontingente für Google Dienste. Neu erstellte Google Workspace-Domains unterliegen möglicherweise vorübergehend strengeren Richtlinien. Kontingenten.

Parameter

NameTypBeschreibung
contentTypeStringDer MIME-Typ, in den konvertiert werden soll. Für die meisten Blobs ist 'application/pdf' ist die einzige gültige Option. Für Bilder im BMP-, GIF-, JPEG- oder PNG-Format gilt auch Folgendes: 'image/bmp', 'image/gif', 'image/jpeg' oder 'image/png' gültig sein. Bei einem Google Docs-Dokument ist 'text/markdown' ebenfalls gültig.

Rückflug

Blob: Die Daten als Blob.


getBytes()

Ruft die in diesem Blob gespeicherten Daten ab.

Rückflug

Byte[]: Die gespeicherten Byte.


getContentType()

Ruft den Inhaltstyp der Byte in diesem Blob ab.

Rückflug

String: Der Inhaltstyp dieser Daten, falls 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

NameTypBeschreibung
charsetStringDer Zeichensatz, der 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 die Lesekontingent.

Rückflug

String: Der SHA1-Inhalts-Hash als String.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:

  • https://mail.google.com/

getName()

Ruft den Namen dieses Blobs ab.

Rückflug

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


getSize()

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

Rückflug

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:

  • https://mail.google.com/

isGoogleType()

Gibt an, ob dieses Blob eine Google Workspace-Datei ist (z. B. Google Tabellen oder Google Docs).

Rückflug

Boolean: true, wenn dieses Blob eine Google Workspace-Datei ist false, wenn nicht.


setBytes(data)

Legt die in diesem Blob gespeicherten Daten fest.

Parameter

NameTypBeschreibung
dataByte[]Die neuen Daten.

Rückflug

Blob: Dieses Blob zur Verkettung.


setContentType(contentType)

Legt den Inhaltstyp der Byte in diesem Blob fest.

Parameter

NameTypBeschreibung
contentTypeStringDer neue Inhaltstyp.

Rückflug

Blob: Dieses Blob zur Verkettung.


setContentTypeFromExtension()

Legt den Inhaltstyp der Byte in diesem Blob basierend auf der Dateiendung fest. Der Inhaltstyp ist null, wenn die Erweiterung nicht erraten werden kann.

Rückflug

Blob: Dieses Blob zur Verkettung.


setDataFromString(string)

Legt die Daten dieses Blobs aus einem String mit UTF-8-Codierung fest.

Parameter

NameTypBeschreibung
stringStringDie Zeichenfolgendaten.

Rückflug

Blob: Dieses Blob zur Verkettung.


setDataFromString(string, charset)

Legt die Daten dieses Blobs aus einem String mit der angegebenen Codierung fest.

Parameter

NameTypBeschreibung
stringStringDie Zeichenfolgendaten.
charsetStringDer Zeichensatz, der zum Interpretieren des Strings als Byte verwendet werden soll.

Rückflug

Blob: Dieses Blob zur Verkettung.


setName(name)

Legt den Namen dieses Blobs fest.

Parameter

NameTypBeschreibung
nameStringDer neue Name

Rückflug

Blob: Dieses Blob zur Verkettung.

Verworfene Methoden