Załącznik z Gmaila. To jest zwykły typ Blob
, ale ma dodatkową metodę getSize()
, która jest szybsza niż wywoływanie getBytes()
.length
i nie wlicza 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 tego obiektu blob. |
getDataAsString() | String | Pobiera dane tego obiektu blob jako ciągu 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 dla tego załącznika. |
getName() | String | Pobiera nazwę tego obiektu blob. |
getSize() | Integer | Pobiera rozmiar tego załącznika. |
isGoogleType() | Boolean | Zwraca, czy dany obiekt blob jest plikiem Google Workspace (Arkuszy, Dokumentów 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 blobowym na podstawie rozszerzenia pliku. |
setDataFromString(string) | Blob | Ustawia dane tego obiektu blob na podstawie 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. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, na przykład „mójplik.pdf”. Zakładamy jednak, że część nazwy pliku, która występuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W związku z tym „Lista zakupów.12.25.2014” zmieni się na „Lista zakupów.12.25.pdf”.
Aby sprawdzić dzienne limity konwersji, przeczytaj artykuł Limity w usługach Google. Nowo utworzone domeny Google Workspace mogą tymczasowo podlegać bardziej rygorystycznym limitom.
Parametry
Nazwa | Typ | Opis |
---|---|---|
contentType | String | Typ MIME, na który ma zostać przekonwertowany. W przypadku większości obiektów blob jedyną prawidłową opcją jest 'application/pdf' . W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG obowiązują dowolne z tych wartości: 'image/bmp' , 'image/gif' , 'image/jpeg' i 'image/png' . |
Powroty
Blob
– dane w postaci obiektu blob.
getBytes()
Pobiera dane przechowywane w tym obiekcie blob.
Powroty
Byte[]
– zapisane bajty.
getContentType()
Pobiera typ treści bajtów tego obiektu blob.
Powroty
String
– typ treści danych (jeśli jest znany) lub null
.
getDataAsString()
Pobiera dane tego obiektu blob jako ciągu znaków z kodowaniem UTF-8.
Powroty
String
– dane w postaci 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, który ma być używany do kodowania danych w tym obiekcie blob jako ciągu znaków. |
Powroty
String
– dane w postaci ciągu znaków.
getHash()
Pobiera hasz treści SHA1 dla tego załącznika. Ta metoda nie wlicza się do limitu odczytu Gmaila.
Powroty
String
– skrót SHA1 treści w postaci ciągu znaków.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
https://mail.google.com/
getName()
Pobiera nazwę tego obiektu blob.
Powroty
String
– nazwa danych, jeśli jest znana, lub null
.
getSize()
Pobiera rozmiar tego załącznika. Ta metoda jest szybsza niż wywoływanie getBytes()
.length
i nie wlicza się do limitu odczytu Gmaila.
Powroty
Integer
– rozmiar załącznika w bajtach.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą powiązanego interfejsu API REST z co najmniej jednym z tych zakresów lub odpowiednich zakresów:
-
https://mail.google.com/
isGoogleType()
Zwraca, czy dany obiekt blob jest plikiem Google Workspace (Arkuszy, Dokumentów itp.).
Powroty
Boolean
– true
, jeśli ten obiekt blob jest plikiem Google Workspace; w przeciwnym razie false
.
setBytes(data)
Ustawia dane przechowywane w tym obiekcie blob.
Parametry
Nazwa | Typ | Opis |
---|---|---|
data | Byte[] | Nowe dane. |
Powroty
Blob
– ten obiekt blob do łańcuchów.
setContentType(contentType)
Ustawia typ treści bajtów w tym obiekcie blob.
Parametry
Nazwa | Typ | Opis |
---|---|---|
contentType | String | Nowy element contentType. |
Powroty
Blob
– ten obiekt blob do łańcuchów.
setContentTypeFromExtension()
Ustawia typ treści bajtów w tym obiekcie blobowym na podstawie rozszerzenia pliku. Atrybut contentType ma wartość null
, jeśli nie można go odgadnąć na podstawie rozszerzenia.
Powroty
Blob
– ten obiekt blob do łańcuchów.
setDataFromString(string)
Ustawia dane tego obiektu blob na podstawie ciągu znaków z kodowaniem UTF-8.
Parametry
Nazwa | Typ | Opis |
---|---|---|
string | String | Dane w postaci ciągu znaków. |
Powroty
Blob
– ten obiekt blob do ł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 znaków. |
charset | String | Zestaw znaków używany do interpretowania ciągu znaków jako bajtów. |
Powroty
Blob
– ten obiekt blob do łańcuchów.
setName(name)
Ustawia nazwę tego obiektu blob.
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nowa nazwa. |
Powroty
Blob
– ten obiekt blob do łańcuchów.