此页面由 Cloud Translation API 翻译。

Class CellImageBuilder

CellImage 的构建器。此构建器会创建将图片添加到单元格所需的图片值。

属性

媒体资源	类型	说明
`valueType`	`ValueType`	一个设置为 `ValueType.IMAGE` 的字段，表示图片值类型。

方法

方法	返回类型	简介
`build()`	`CellImage`	创建将图片添加到单元格所需的图片值类型。
`getAltTextDescription()`	`String`	返回此图片的替代文本说明。
`getAltTextTitle()`	`String`	返回此图片的替代文本标题。
`getContentUrl()`	`String`	返回图片的 Google 托管网址。
`getUrl()`	`String`	获取图片的来源网址；如果网址不可用，则返回 `null`。
`setAltTextDescription(description)`	`CellImage`	设置此图片的替代文本说明。
`setAltTextTitle(title)`	`CellImage`	设置此图片的替代文本标题。
`setSourceUrl(url)`	`CellImageBuilder`	设置图片来源网址。
`toBuilder()`	`CellImageBuilder`	创建一个构建器，用于将图像转换为图像值类型，以便您可以将其放入单元格。

详细文档

`build()`

创建将图片添加到单元格所需的图片值类型。映像值根据添加到构建器的图片属性（例如源网址）构建。

弃踢回攻

CellImage - 要添加到单元格的图片的表示形式。

`getAltTextDescription()`

返回此图片的替代文本说明。

弃踢回攻

String - 替代文本说明。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getAltTextTitle()`

返回此图片的替代文本标题。

弃踢回攻

String - 替代文本标题。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getContentUrl()`

返回图片的 Google 托管网址。此网址带有请求者的帐号标记，因此知道此网址的任何人都可以以原始请求者的身份有效地访问图片。如果电子表格的共享设置发生变化，可能会失去对图片的访问权限。返回的网址会在不久后过期。

弃踢回攻

String - 图片的 Google 托管网址。

`getUrl()`

获取图片的来源网址；如果网址不可用，则返回 null。如果图片是使用 API 通过网址插入的，此方法会返回在插入图片期间提供的网址。

弃踢回攻

String - 图片网址（如果有）；如果图片不可用或没有来源网址，则返回 null。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setAltTextDescription(description)`

设置此图片的替代文本说明。

参数

名称	类型	说明
`description`	`String`	图片的新替代文本说明。

弃踢回攻

CellImage - 此图片，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setAltTextTitle(title)`

设置此图片的替代文本标题。

参数

名称	类型	说明
`title`	`String`	图片的新替代文本标题。

弃踢回攻

CellImage - 此图片，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setSourceUrl(url)`

设置图片来源网址。

参数

名称	类型	说明
`url`	`String`	图片的网址。

弃踢回攻

CellImageBuilder - 此构建器，用于链接。

`toBuilder()`

创建一个构建器，用于将图像转换为图像值类型，以便您可以将其放入单元格。在将图片放入单元格之前，您需要先将图片创建为图片值类型。然后，您可以使用 Range.setValue(value) 或 Range.setValues(values) 将其添加到单元格。

弃踢回攻

CellImageBuilder - 一个构建器，用于根据给定的图片属性创建图片值类型。