Class CellImage

CellImage

表示要添加到单元格的图片。如需将图片添加到单元格,您必须使用 SpreadsheetApp.newCellImage()CellImageBuilder 为图片创建新的图片值。然后,您可以使用 Range.setValue(value)Range.setValues(values) 将图片值添加到单元格。

属性

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

方法

方法返回类型简介
getAltTextDescription()String返回此图片的替代文本说明。
getAltTextTitle()String返回此图片的替代文本标题。
getContentUrl()String返回图片的 Google 托管网址。
getUrl()String获取图片的来源网址;如果网址不可用,则返回 null
toBuilder()CellImageBuilder创建一个构建器,用于将图像转换为图像值类型,以便您可以将其放入单元格。

详细文档

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

toBuilder()

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

弃踢回攻

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