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

Class 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。