Class CellImage

Изображение ячейки

Представляет значение изображения в ячейке. Чтобы добавить изображение в ячейку, вы должны создать новое значение изображения для изображения с помощью Spreadsheet App.newCellImage() и Cell Image Builder . Затем вы можете использовать Range.setValue(value) или Range.setValues(values) чтобы добавить значение изображения в ячейку.

Характеристики

Свойство Тип Описание
value Type Value Type Тип значения изображения ячейки — Value Type.IMAGE .

Методы

Метод Тип возврата Краткое описание
get Alt Text Description() String Возвращает альтернативное текстовое описание для этого изображения.
get Alt Text Title() String Возвращает замещающий текстовый заголовок для этого изображения.
get Content Url() String Возвращает URL-адрес изображения, размещенный в Google.
to Builder() Cell Image Builder Создает построитель изображений ячеек на основе текущих свойств изображения.

Подробная документация

get Alt Text Description()

Возвращает альтернативное текстовое описание для этого изображения.

Возвращаться

String — описание альтернативного текста.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Alt Text Title()

Возвращает замещающий текстовый заголовок для этого изображения.

Возвращаться

String — заголовок альтернативного текста.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

get Content Url()

Возвращает URL-адрес изображения, размещенный в Google. Этот URL-адрес помечен учетной записью запрашивающего, поэтому любой, у кого есть URL-адрес, фактически получает доступ к изображению как исходный запрашивающий. Доступ к изображению может быть потерян, если изменяются настройки общего доступа к электронной таблице. Срок действия возвращенного URL-адреса истекает через короткий период времени.

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

Возвращаться

String — URL-адрес изображения, размещенный в Google.

to Builder()

Создает построитель изображений ячеек на основе текущих свойств изображения. Используйте Cell Image Builder.setSourceUrl(url) чтобы установить исходный 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);
}

Возвращаться

Cell Image Builder — построитель, который создает тип значения изображения на основе заданных свойств изображения.

Устаревшие методы