本頁面由 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 的副本。

Return 鍵

Blob — 新副本。

`getAs(contentType)`

傳回此物件中的資料，以轉換為指定內容類型的 blob。這個方法會在檔案名稱中加上適當的副檔名，例如「quofile;myfile.pdf"」。但其假設，最後一個月後面的檔案名稱部分 (如果有) 是必須取代的現有副檔名。因此「quoList;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'` 中任何一個都是有效的。

Return 鍵

Blob — 將資料以 blob 形式呈現。

`getBytes()`

取得這個 blob 中儲存的資料。

Return 鍵

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

`getContentType()`

取得這個 blob 中位元組的內容類型。

Return 鍵

String：這項資料的類型 (如果已知，則設為 null)。

`getDataAsString()`

取得這個 blob 資料，並以 UTF-8 編碼做為字串。

Return 鍵

String — 以字串形式的資料。

`getDataAsString(charset)`

以指定的編碼方式取得這個 blob 的資料。

參數

名稱	類型	說明
`charset`	`String`	用於將這個 blob 中的資料編碼為字串的字元集。

Return 鍵

String — 以字串形式的資料。

`getName()`

取得這個 blob 的名稱。

Return 鍵

String：這項資料的名稱，如已知，或 null。

`isGoogleType()`

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

Return 鍵

Boolean — 如果這個 blob 是 Google Workspace 檔案，則為 true；如果不是，則傳回 false。

`setBytes(data)`

設定這個 blob 中儲存的資料。

參數

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

Return 鍵

Blob — 這個 blob 用於鏈結。

`setContentType(contentType)`

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

參數

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

Return 鍵

Blob — 這個 blob 用於鏈結。

`setContentTypeFromExtension()`

根據副檔名設定這個 blob 的位元組內容類型。如果無法透過擴充功能猜測 contentType 為 null。

Return 鍵

Blob — 這個 blob 用於鏈結。

`setDataFromString(string)`

使用 UTF-8 編碼的字串設定這個 blob 的資料。

參數

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

Return 鍵

Blob — 這個 blob 用於鏈結。

`setDataFromString(string, charset)`

使用包含指定編碼的字串設定這個 blob 的資料。

參數

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

Return 鍵

Blob — 這個 blob 用於鏈結。

`setName(name)`

設定這個 blob 的名稱。

參數

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

Return 鍵

Blob — 這個 blob 用於鏈結。

已淘汰的方法

`getAllBlobs()`

已淘汰。此函式已淘汰不用，無法用於新指令碼中。

取得這個 (甚至是複合) blob 包含的所有 blob。

Return 鍵

Blob[]：— blob 中包含的 blob。