Class CellImageBuilder

CellImageBuilder

Конструктор для CellImage . Этот конструктор создает значение изображения, необходимое для добавления изображения в ячейку.

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

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

Методы

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

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

build()

Создает тип значения изображения, необходимый для добавления изображения в ячейку. Значение изображения формируется на основе свойств изображения, добавленных в конструктор, таких как URL-адрес источника.

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

CellImage — Изображение, которое нужно добавить в ячейку.

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.

setAltTextDescription(description)

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

Параметры

Имя Тип Описание
description String Новое альтернативное описание для изображения.

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

CellImage — Это изображение используется для создания цепочек.

Авторизация

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

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

setAltTextTitle(title)

Задает альтернативный текст для этого изображения.

Параметры

Имя Тип Описание
title String Новый альтернативный текст для изображения.

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

CellImage — Это изображение используется для создания цепочек.

Авторизация

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

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

setSourceUrl(url)

Задает URL-адрес источника изображения.

Параметры

Имя Тип Описание
url String URL изображения.

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

CellImageBuilder — Этот конструктор предназначен для создания цепочек объектов.

toBuilder()

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

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