本頁面由 Cloud Translation API 翻譯而成。

Class Blob

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

方法

方法	傳回類型	簡短說明
`copyBlob()`	`Blob`	傳回這個 blob 的副本。
`getAs(contentType)`	`Blob`	以 blob 的形式傳回這個物件中的資料，做為轉換成指定內容類型的 blob。
`getBytes()`	`Byte[]`	取得這個 blob 中儲存的資料。
`getContentType()`	`String`	取得這個 blob 中位元組的內容型別。
`getDataAsString()`	`String`	取得這個 blob 的資料，做為使用 UTF-8 編碼的字串。
`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 的形式傳回這個物件中的資料，做為轉換成指定內容類型的 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()`

取得這個 blob 的資料，做為使用 UTF-8 編碼的字串。

回攻員

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。