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