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