Class Blob

Apps 脚本服务的数据交换对象。

方法

方法	返回类型	简介
`copyBlob()`	`Blob`	返回相应 blob 的副本。
`getAs(contentType)`	`Blob`	以转换为指定内容类型的 blob 形式返回此对象内的数据。
`getBytes()`	`Byte[]`	获取存储在此 blob 中的数据。
`getContentType()`	`String\|null`	获取相应 blob 中字节的内容类型。
`getDataAsString()`	`String`	以 UTF-8 编码获取相应 blob 的数据（以字符串形式）。
`getDataAsString(charset)`	`String`	以指定编码获取相应 blob 的数据（以字符串形式）。
`getName()`	`String\|null`	获取相应 blob 的名称。
`isGoogleType()`	`Boolean`	返回相应 Blob 是否为 Google Workspace 文件（Google 表格、Google 文档等）。
`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 - 此数据的内容类型（如果已知），否则为 null。

`getDataAsString()`

以 UTF-8 编码获取相应 blob 的数据（以字符串形式）。

String - 以字符串形式表示的数据。

`getDataAsString(charset)`

以指定编码获取相应 blob 的数据（以字符串形式）。

参数

名称	类型	说明
`charset`	`String`	用于将相应 blob 中的数据编码为字符串的字符集。

String - 以字符串形式表示的数据。

`getName()`

获取相应 blob 的名称。

String|null - 相应数据的名称（如果已知），否则为 null。

`isGoogleType()`

返回相应 Blob 是否为 Google Workspace 文件（Google 表格、Google 文档等）。

Boolean - 如果相应 blob 是 Google Workspace 文件，则为 true；否则为 false。

`setBytes(data)`

设置存储在此 blob 中的数据。

参数

名称	类型	说明
`data`	`Byte[]`	新数据。

Blob - 此 blob，用于链式调用。

`setContentType(contentType)`

设置相应 blob 中字节的内容类型。

参数

名称	类型	说明
`contentType`	`String`	新的 contentType。

Blob - 此 blob，用于链式调用。

`setContentTypeFromExtension()`

根据文件扩展名设置此 blob 中字节的内容类型。如果无法从扩展名中推断出 contentType，则 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。

Class Blob 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

方法

已弃用的方法

详细文档

copyBlob()

返回

getAs(contentType)

参数

返回

getBytes()

返回

getContentType()

返回

getDataAsString()

返回

getDataAsString(charset)

参数

返回

getName()

返回

isGoogleType()

返回

setBytes(data)

参数

返回

setContentType(contentType)

参数

返回

setContentTypeFromExtension()

返回

setDataFromString(string)

参数

返回

setDataFromString(string, charset)

参数

返回

setName(name)

参数

返回

已弃用的方法

getAllBlobs()

返回

Class Blob

`copyBlob()`

`getAs(contentType)`

`getBytes()`

`getContentType()`

`getDataAsString()`

`getDataAsString(charset)`

`getName()`

`isGoogleType()`

`setBytes(data)`

`setContentType(contentType)`

`setContentTypeFromExtension()`

`setDataFromString(string)`

`setDataFromString(string, charset)`

`setName(name)`

`getAllBlobs()`