Einen Anhang aus Gmail. Dies ist eine reguläre Blob
, mit der Ausnahme, dass sie eine zusätzliche getSize()
-Methode hat, die schneller als der Aufruf von getBytes()
.length
ist und nicht auf das Gmail-Lesekontingent angerechnet wird.
// 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
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 | 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-Inhalts-Hash für diesen Anhang ab. |
getName() | String | Ruft den Namen dieses Blobs ab. |
getSize() | Integer | Ruft die Größe des Anhangs ab. |
isGoogleType() | Boolean | Gibt zurück, ob dieses Blob eine Google Workspace-Datei (Google Tabellen, 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 basierend auf 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. |
Detaillierte Dokumentation
copyBlob()
getAs(contentType)
Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. "myfile.pdf". Dabei wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt (falls vorhanden) folgt, eine vorhandene Erweiterung ist, die ersetzt werden sollte. Aus „ShoppingList.12.25.2014“ wird dann „ShoppingList.12.25.pdf“.
Informationen zu den Tageskontingenten 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. |
Return
Blob
: Die Daten als Blob.
getBytes()
Ruft die in diesem Blob gespeicherten Daten ab.
Return
Byte[]
: Die gespeicherten Byte.
getContentType()
Ruft den Inhaltstyp der Byte in diesem Blob ab.
Return
String
: Der Inhaltstyp dieser Daten, falls bekannt, oder null
.
getDataAsString()
Ruft die Daten dieses Blobs als String mit UTF-8-Codierung ab.
Return
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. |
Return
String
: Die Daten als String.
getHash()
Ruft den SHA1-Inhalts-Hash für diesen Anhang ab. Diese Methode wird nicht auf das Gmail-Lesekontingent angerechnet.
Return
String
: Der SHA1-Inhalts-Hash als String.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
getName()
Ruft den Namen dieses Blobs ab.
Return
String
– Der Name dieser Daten, falls bekannt, oder null
.
getSize()
Ruft die Größe des Anhangs ab. Diese Methode ist schneller als das Aufrufen von getBytes()
.length
und wird nicht auf das Gmail-Lesekontingent angerechnet.
Return
Integer
: Die Größe des Anhangs in Byte.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
isGoogleType()
Gibt zurück, ob dieses Blob eine Google Workspace-Datei (Google Tabellen, Google Docs usw.) ist.
Return
Boolean
: true
, wenn dieses Blob eine Google Workspace-Datei ist; false
, wenn nicht.
setBytes(data)
Legt die in diesem Blob gespeicherten Daten fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
data | Byte[] | Die neuen Daten. |
Return
Blob
: Dieses Blob zum Verketten.
setContentType(contentType)
Legt den Inhaltstyp der Byte in diesem Blob fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
contentType | String | Der neue contentType. |
Return
Blob
: Dieses Blob zum Verketten.
setContentTypeFromExtension()
Legt den Inhaltstyp der Byte in diesem Blob basierend auf der Dateiendung fest. Der contentType lautet null
, wenn er nicht anhand seiner Erweiterung erraten werden kann.
Return
Blob
: Dieses Blob zum Verketten.
setDataFromString(string)
Legt die Daten dieses Blobs aus einem String mit UTF-8-Codierung fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
string | String | Die Zeichenfolgendaten. |
Return
Blob
: Dieses Blob zum Verketten.
setDataFromString(string, charset)
Legt die Daten dieses Blobs aus einem String mit der angegebenen Codierung fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
string | String | Die Zeichenfolgendaten. |
charset | String | Der Zeichensatz, der zur Interpretation des Strings als Byte verwendet werden soll. |
Return
Blob
: Dieses Blob zum Verketten.
setName(name)
Legt den Namen dieses Blobs fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
name | String | Der neue Name |
Return
Blob
: Dieses Blob zum Verketten.