Class CellImageBuilder

建立將圖片新增至儲存格所需的圖片值類型。圖片值會根據新增至建構工具的圖片屬性 (例如來源網址) 建構。

回攻員

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

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

回攻員

String：替代文字說明。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

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

回攻員

String：替代文字標題。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

傳回 Google 代管的圖片網址。這個網址會標記要求者的帳戶，因此任何擁有該網址的使用者都能以原始要求者的身分存取圖片。如果試算表的共用設定有所變更，您可能會失去圖片的存取權。傳回的網址會在短時間內失效。

const range = SpreadsheetApp.getActiveSpreadsheet().getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  console.log(value.getContentUrl());
}

回攻員

String：圖片的 Google 代管網址。

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

參數

回攻員

CellImage：這張圖片，用於鏈結。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

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

參數

回攻員

CellImage：此圖片，用於鏈結。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

設定圖片來源網址。

參數

回攻員

CellImageBuilder：這個建構工具可用於鏈結。

根據目前的圖片屬性建立單元格圖片建構工具。使用 setSourceUrl(url) 設定新圖片的來源網址。接著，您可以使用 Range.setValue(value) 或 Range.setValues(values) 將其新增至單元格。

const ss = SpreadsheetApp.getActiveSpreadsheet();
const range = ss.getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  const newImage =
      value.toBuilder()
          .setSourceUrl(
              'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png',
              )
          .build();
  const newRange = ss.getRange("Sheet1!A2");
  newRange.setValue(newImage);
}

回攻員

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