本頁面由 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：這個建構工具可根據指定圖片屬性建立圖片值類型。