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

Class Blob

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

方法

方法	傳回類型	簡短說明
`copyBlob()`	`Blob`	傳回這個 blob 的副本。
`getAs(contentType)`	`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。這個方法會在檔案名稱中加入適當的副檔名，例如「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'` 中的任一個也是有效的格式。

回攻員

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 — true 表示這個 blob 是 Google Workspace 檔案；如果不是 Google Workspace 檔案，則為 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。