Представляет изображение, добавляемое в ячейку. Чтобы добавить изображение в ячейку, вы должны создать новое значение изображения для изображения с помощью SpreadsheetApp.newCellImage()
и CellImageBuilder
. Затем вы можете использовать Range.setValue(value)
или Range.setValues(values)
, чтобы добавить значение изображения в ячейку.
Характеристики
Свойство | Тип | Описание |
---|---|---|
valueType | ValueType | Поле, которому присвоено значение ValueType.IMAGE , представляющее тип значения изображения. |
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
getAltTextDescription() | String | Возвращает альтернативное текстовое описание для этого изображения. |
getAltTextTitle() | String | Возвращает замещающий текстовый заголовок для этого изображения. |
getContentUrl() | String | Возвращает URL-адрес изображения, размещенный в Google. |
getUrl() | String | Получает исходный URL-адрес изображения; возвращает значение null если URL-адрес недоступен. |
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()
Возвращает URL-адрес изображения, размещенный в Google. Этот URL-адрес помечен учетной записью запрашивающего, поэтому любой, у кого есть URL-адрес, фактически получает доступ к изображению как исходный запрашивающий. Доступ к изображению может быть потерян, если изменяются настройки общего доступа к электронной таблице. Срок действия возвращенного URL-адреса истекает через короткий период времени.
Возвращаться
String
— URL-адрес изображения, размещенный в Google.
getUrl()
Получает исходный URL-адрес изображения; возвращает значение null
если URL-адрес недоступен. Если изображение было вставлено по URL-адресу с помощью API, этот метод возвращает URL-адрес, указанный во время вставки изображения.
Возвращаться
String
— URL-адрес изображения, если он доступен; возвращает null
если изображение недоступно или не имеет исходного URL-адреса.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
toBuilder()
Создает построитель, который преобразует изображение в тип значения изображения, чтобы его можно было поместить в ячейку. Прежде чем изображение будет помещено в ячейку, его необходимо создать как тип значения изображения. Затем вы можете добавить его в ячейку, используя Range.setValue(value)
или Range.setValues(values)
.
Возвращаться
CellImageBuilder
— Построитель, который создает тип значения изображения на основе заданных свойств изображения.