Class Blob | Apps Script | Google for Developers (original) (raw)

Blob

Apps Script 服務的資料交換物件。

方法

方法	傳回類型	簡短說明
copyBlob()	Blob	傳回此 Blob 的副本。
getAs(contentType)	Blob	將此物件內的資料傳回為轉換為指定內容類型的 Blob。
getBytes()	Byte[]	取得儲存在此 Blob 中的資料。
getContentType()	String	取得此 Blob 中位元組的內容類型。
getDataAsString()	String	以 UTF-8 編碼的字串格式，取得此 Blob 的資料。
getDataAsString(charset)	String	以指定的編碼方式，取得此 blob 的資料做為字串。
getName()	String	取得 Blob 的名稱。
isGoogleType()	Boolean	傳回這個 Blob 是否為 Google Workspace 檔案 (試算表、文件等)。
setBytes(data)	Blob	設定儲存在此 Blob 中的資料。
setContentType(contentType)	Blob	設定此 blob 中位元組的內容類型。
setContentTypeFromExtension()	Blob	根據檔案副檔名，設定此 Blob 中位元組的內容類型。
setDataFromString(string)	Blob	從採用 UTF-8 編碼的字串，設定此 blob 的資料。
setDataFromString(string, charset)	Blob	從使用指定編碼的字串中，設定此 blob 的資料。
setName(name)	Blob	設定此 Blob 的名稱。

已淘汰的方法

方法	傳回類型	簡短說明
~~getAllBlobs()~~	Blob[]	取得此 (可能為複合) Blob 內含的所有 Blob。

內容詳盡的說明文件

`copyBlob()`

傳回此 Blob 的副本。

回攻員

[Blob](#)：新副本。

`getAs(contentType)`

將此物件內的資料傳回為轉換為指定內容類型的 Blob。這個方法會在檔案名稱中加入適當的副檔名，例如「myfile.pdf」。不過，這會假設檔案名稱中最後一個句點 (如有) 後面的部分是應取代的現有副檔名。因此，「ShoppingList.12.25.2014」會變成「ShoppingList.12.25.pdf」。

如要查看轉換的每日配額，請參閱「Google 服務的配額」。新建立的 Google Workspace 網域可能會暫時受到較嚴格的配額限制。

參數

名稱	類型	說明
contentType	String	要轉換的 MIME 類型。對於大多數 Blob 而言，'application/pdf' 是唯一有效的選項。如果是 BMP、GIF、JPEG 或 PNG 格式的圖片，'image/bmp'、'image/gif'、'image/jpeg' 或 'image/png' 皆可用。如果是 Google 文件，'text/markdown' 也是有效的。

回攻員

[Blob](#)：資料為 Blob。

`getBytes()`

取得儲存在此 Blob 中的資料。

回攻員

Byte[]：已儲存的位元組。

`getContentType()`

取得此 Blob 中位元組的內容類型。

回攻員

String：此資料的內容類型 (如果已知)，或 null。

`getDataAsString()`

以 UTF-8 編碼的字串格式，取得此 Blob 的資料。

回攻員

String：資料以字串形式呈現。

`getDataAsString(charset)`

以指定的編碼方式，取得此 blob 的資料做為字串。

參數

名稱	類型	說明
charset	String	用於將此 Blob 中的資料編碼為字串的字元集。

回攻員

String：資料以字串形式呈現。

`getName()`

取得 Blob 的名稱。

回攻員

String：如果已知這項資料的名稱，則為這項資料的名稱；否則為 null。

`isGoogleType()`

傳回這個 Blob 是否為 Google Workspace 檔案 (試算表、文件等)。

回攻員

Boolean：如果這個 Blob 是 Google Workspace 檔案，則為 true；否則為 false。

`setBytes(data)`

設定儲存在此 Blob 中的資料。

參數

名稱	類型	說明
data	Byte[]	新資料。

回攻員

[Blob](#)：這個 blob，用於鏈結。

`setContentType(contentType)`

設定此 blob 中位元組的內容類型。

參數

名稱	類型	說明
contentType	String	新的 contentType。

回攻員

[Blob](#)：這個 blob，用於鏈結。

`setContentTypeFromExtension()`

根據檔案副檔名，設定此 Blob 中位元組的內容類型。如果無法從擴充功能猜測 contentType，則為 null。

回攻員

[Blob](#)：這個 blob，用於鏈結。

`setDataFromString(string)`

從採用 UTF-8 編碼的字串，設定此 blob 的資料。

參數

名稱	類型	說明
string	String	字串資料。

回攻員

[Blob](#)：這個 blob，用於鏈結。

`setDataFromString(string, charset)`

從使用指定編碼的字串中，設定此 blob 的資料。

參數

名稱	類型	說明
string	String	字串資料。
charset	String	用於將字串解讀為位元組的字元集。

回攻員

[Blob](#)：這個 blob，用於鏈結。

`setName(name)`

設定此 Blob 的名稱。

參數

名稱	類型	說明
name	String	新名稱。

回攻員

[Blob](#)：這個 blob，用於鏈結。

已淘汰的方法

`getAllBlobs()`

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得此 (可能為複合) Blob 內含的所有 Blob。

回攻員

[Blob[]](#)：Blob 內含的 Blob。

除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。

上次更新時間：2025-12-11 (世界標準時間)。