Załącznik z Gmaila. To standardowa metoda Blob
, różniąca się tym, że zawiera dodatkową metodę getSize()
, która jest szybsza niż dzwonienie.
getBytes()
.length
i nie wliczają się do limitu odczytu Gmaila.
// 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()); } } }
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
copyBlob() | Blob | Zwraca kopię tego obiektu blob. |
getAs(contentType) | Blob | Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. |
getBytes() | Byte[] | Pobiera dane przechowywane w tym obiekcie blob. |
getContentType() | String | Pobiera typ treści bajtów w tym obiekcie blob. |
getDataAsString() | String | Pobiera dane tego obiektu blob jako ciąg znaków z kodowaniem UTF-8. |
getDataAsString(charset) | String | Pobiera dane tego obiektu blob jako ciąg znaków o określonym kodowaniu. |
getHash() | String | Pobiera hasz treści SHA1 tego załącznika. |
getName() | String | Pobiera nazwę tego obiektu blob. |
getSize() | Integer | Pobiera rozmiar załącznika. |
isGoogleType() | Boolean | Zwraca, czy dany obiekt blob jest plikiem Google Workspace (obejmuje to Arkusze, Dokumenty itp.). |
setBytes(data) | Blob | Ustawia dane przechowywane w tym obiekcie blob. |
setContentType(contentType) | Blob | Ustawia typ treści bajtów w tym obiekcie blob. |
setContentTypeFromExtension() | Blob | Ustawia typ treści bajtów w tym obiekcie blob na podstawie rozszerzenia pliku. |
setDataFromString(string) | Blob | Ustawia dane tego obiektu blob z ciągu znaków z kodowaniem UTF-8. |
setDataFromString(string, charset) | Blob | Ustawia dane tego obiektu blob z ciągu znaków o określonym kodowaniu. |
setName(name) | Blob | Ustawia nazwę tego obiektu blob. |
Szczegółowa dokumentacja
copyBlob()
getAs(contentType)
Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ten dodaje do nazwy pliku odpowiednie rozszerzenie, na przykład „mojplik.pdf”. Jednak zakłada, że część nazwy pliku, która następuje po ostatnim kropce (jeśli występuje), jest już , które należy zastąpić. W rezultacie „ShoppingList.12.25.2014” zmienia się w „ShoppingList.12.25.pdf”.
Aby wyświetlić dzienne limity konwersji, zobacz Limity dla Google Usługi. Nowo utworzone domeny Google Workspace mogą być tymczasowo bardziej rygorystyczne limity.
Parametry
Nazwa | Typ | Opis |
---|---|---|
contentType | String | Typ MIME do skonwertowania. W przypadku większości blobów atrybut 'application/pdf' to
jedyną prawidłową opcją. W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG możesz też użyć dowolnego z tych atrybutów: 'image/bmp' , 'image/gif' , 'image/jpeg' lub 'image/png' .
prawidłowe. W przypadku dokumentów w Dokumentach Google prawidłowa jest też wartość 'text/markdown' . |
Powrót
Blob
– dane w postaci obiektu blob.
getBytes()
Pobiera dane przechowywane w tym obiekcie blob.
Powrót
Byte[]
– zapisane bajty.
getContentType()
Pobiera typ treści bajtów w tym obiekcie blob.
Powrót
String
– typ treści danych (jeśli jest znany) lub null
.
getDataAsString()
Pobiera dane tego obiektu blob jako ciąg znaków z kodowaniem UTF-8.
Powrót
String
– dane w formie ciągu znaków.
getDataAsString(charset)
Pobiera dane tego obiektu blob jako ciąg znaków o określonym kodowaniu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
charset | String | Zestaw znaków używany do kodowania danych w tym obiekcie blob jako ciąg znaków. |
Powrót
String
– dane w formie ciągu znaków.
getHash()
Pobiera hasz treści SHA1 tego załącznika. Ta metoda nie jest wliczana do Gmaila limit odczytu.
Powrót
String
– hasz treści SHA1 w postaci ciągu znaków.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
getName()
Pobiera nazwę tego obiektu blob.
Powrót
String
– nazwa danych (jeśli jest znana) lub null
.
getSize()
Pobiera rozmiar załącznika. Ta metoda jest szybsza niż wywoływanie getBytes()
.length
i nie wliczają się do limitu odczytu Gmaila.
Powrót
Integer
– rozmiar załącznika w bajtach.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
isGoogleType()
Zwraca, czy dany obiekt blob jest plikiem Google Workspace (obejmuje to Arkusze, Dokumenty itp.).
Powrót
Boolean
– true
, jeśli ten obiekt blob jest plikiem Google Workspace; false
.
setBytes(data)
Ustawia dane przechowywane w tym obiekcie blob.
Parametry
Nazwa | Typ | Opis |
---|---|---|
data | Byte[] | Nowe dane. |
Powrót
Blob
– ten blob do tworzenia łańcuchów.
setContentType(contentType)
Ustawia typ treści bajtów w tym obiekcie blob.
Parametry
Nazwa | Typ | Opis |
---|---|---|
contentType | String | Nowa wartość contentType. |
Powrót
Blob
– ten blob do tworzenia łańcuchów.
setContentTypeFromExtension()
Ustawia typ treści bajtów w tym obiekcie blob na podstawie rozszerzenia pliku. Wartość ContentType to
null
, jeśli nie można go odgadnąć na podstawie rozszerzenia.
Powrót
Blob
– ten blob do tworzenia łańcuchów.
setDataFromString(string)
Ustawia dane tego obiektu blob z ciągu znaków z kodowaniem UTF-8.
Parametry
Nazwa | Typ | Opis |
---|---|---|
string | String | Dane w postaci ciągu. |
Powrót
Blob
– ten blob do tworzenia łańcuchów.
setDataFromString(string, charset)
Ustawia dane tego obiektu blob z ciągu znaków o określonym kodowaniu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
string | String | Dane w postaci ciągu. |
charset | String | Zestaw znaków używany do interpretowania ciągu znaków jako bajtów. |
Powrót
Blob
– ten blob do tworzenia łańcuchów.
setName(name)
Ustawia nazwę tego obiektu blob.
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nowa nazwa. |
Powrót
Blob
– ten blob do tworzenia łańcuchów.