Class CellImage

CellImage

Представляет значение изображения в ячейке. Чтобы добавить изображение в ячейку, необходимо создать новое значение изображения, используя SpreadsheetApp.newCellImage() и CellImageBuilder . Затем можно использовать 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 Создает конструктор изображений ячеек на основе текущих свойств изображения.

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

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()

Возвращает 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.

toBuilder()

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

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

CellImageBuilder — это конструктор, который создает тип значения изображения на основе заданных свойств изображения.

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