本頁面由 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()`

建立要在儲存格中新增圖片所需的圖片值類型。映像檔值是以新增至建構工具的圖片屬性為基礎，例如來源網址。

Return 鍵

CellImage：代表要新增至儲存格的圖片。

`getAltTextDescription()`

傳回此圖片的替代文字說明。

Return 鍵

String：替代文字說明。

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`getAltTextTitle()`

傳回此圖片的替代文字標題。

Return 鍵

String：替代文字標題。

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`getContentUrl()`

傳回 Google 代管的圖片網址。這個網址會標上要求者的帳戶，因此凡是知道網址的人，都能以原始要求者的身分存取圖片。如果試算表的共用設定有所變更，可能無法存取圖片。傳回的網址會在短時間內失效。

Return 鍵

String：圖片的 Google 代管網址。

`getUrl()`

取得映像檔的來源網址；如果網址無法使用，則傳回 null。如果圖片是透過 API 插入，這個方法會傳回圖片插入期間提供的網址。

Return 鍵

String — 圖片網址 (如果有的話)。如果圖片無法使用或沒有來源網址，會傳回 null。

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`setAltTextDescription(description)`

設定這張圖片的替代文字說明。

參數

名稱	類型	說明
`description`	`String`	新的圖片替代文字說明。

Return 鍵

CellImage — 用於鏈結的圖片。

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`setAltTextTitle(title)`

設定這張圖片的替代文字標題。

參數

名稱	類型	說明
`title`	`String`	圖片的新替代文字標題。

Return 鍵

CellImage — 用於鏈結的圖片。

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`setSourceUrl(url)`

設定圖片來源網址。

參數

名稱	類型	說明
`url`	`String`	圖片的網址。

Return 鍵

CellImageBuilder — 用於鏈結的建構工具。

`toBuilder()`

建立可將圖片轉換為圖片值類型的建構工具，以便將圖片放入儲存格。您必須先將圖片建立成儲存格，才能將其置於儲存格中。然後使用 Range.setValue(value) 或 Range.setValues(values) 將其新增至儲存格。

Return 鍵

CellImageBuilder：根據指定圖片屬性建立圖片值類型的建構工具。