Структуры данных в электронных таблицах

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

Электронная таблица

Эта структура представляет собой одну электронную таблицу, хранящуюся в Модели.

Формат записи:

Имя поля

Тип поля

Описание поля

name

String

Имя электронной таблицы.

description

String

Описание электронной таблицы.

autoEvaluationEnabled

Boolean

Включает пересчет формул в фоновом режиме.

data

Data Table

Данные электронной таблицы.

Данные электронной таблицы

Эта структура определяет данные, возвращаемые электронной таблицей.

Формат записи:

Имя поля

Тип поля

Описание поля

cells

Data Table

Данные ячейки электронной таблицы. (см. Ячейка).

mergedRanges

Data Table

Информация об объединенных диапазонах ячеек. (см. Диапазон).

groups

Data Table

Информация о сгруппированных строках и столбцах. (см. Группа).

rowsMetadata

Data Table

Метаданные для строк электронной таблицы. (см. Свойства измерения).

columnsMetadata

Data Table

Метаданные для колонок электронной таблицы. (см. Свойства измерения).

properties

Data Table

Общие свойства электронной таблицы. (см. Свойства электронной таблицы).

conditionalFormats

Data Table

Правила условного форматирования, применяемые в электронной таблице. (см. Условное форматирование).

styles

Data Table

Определения стилей ячеек, используемые в электронной таблице. (см. Стили).

formats

Data Table

Определения форматов ячеек, используемые в электронной таблице. (см. Форматы).

Свойства электронной таблицы

Эта структура определяет общие свойства электронной таблицы.

Формат записи:

Имя поля

Тип поля

Описание поля

frozenRowCount

Integer

Количество зафиксированных строк.

frozenColumnCount

Integer

Количество зафиксированных колонок.

hideGridlines

Boolean

Если значение true, сетки скрываются.

showFormulas

Boolean

Если значение true, вместо расчетных значений отображаются формулы.

Ячейка

Эта структура определяет данные ячейки электронной таблицы.

Формат записи:

Имя поля

Тип поля

Описание поля

rowIndex

Integer

Индекс строки ячейки, начиная с нуля.

columnIndex

Integer

Индекс столбца ячейки, начиная с ноля.

value

String

Значение ячейки.

binding

String

Выражение ячейки или привязка.

formatId

Long

Идентификатор формата, примененного к ячейке (см. Форматы).

cellFormat

String

Формат ячейки. (Это поле предназначено только для внутреннего использования).

styleId

Long

Идентификатор стиля, примененного к ячейке (см. Стиль элемента).

cellStyle

Data Table

Данные стиля ячейки (см. Стиль ячейки). (Это поле предназначено только для внутреннего использования).

error

Data Table

Данные об ошибках ячейки (см. Ошибка ячейки).

comments

Data Table

Комментарии к ячейкам (см. Комментарий).

Стиль ячейки

Эта структура определяет свойства визуального стиля ячейки.

Формат записи:

Имя поля

Тип поля

Описание поля

fontFamily

String

Название семейства шрифтов.

fontSize

Integer

Размер шрифта.

fontWeight

Boolean

Если true, применяется полужирный шрифт.

fontItalic

Boolean

Если true, применяется шрифт Курсив.

strike

Boolean

Если true, применяется зачеркивание.

underline

Boolean

Если true, применяется подчеркивание.

fontColor

Цвет

Цвет текста.

backgroundColor

Цвет

Цвет фона ячейки.

verticalAlign

String

Вертикальное выравнивание. Поддерживаемые значения:

  • top

  • middle

  • bottom.

horizontalAlignment

String

Горизонтальное выравнивание. Поддерживаемые значения:

  • left

  • center

  • right.

borderLeft

String

Стиль левой рамки, например 1px solid #000000FF.

borderRight

String

Стиль рамки справа, например 1px solid #000000FF.

borderTop

String

Стиль верхней рамки, например 1px solid #000000FF.

borderBottom

String

Стиль нижней рамки, например 1px solid #000000FF.

textTransfer

String

Режим обтекания текста. Поддерживаемые значения:

  • trim

  • transfer

  • overlay.

Ошибка ячейки

Эта структура определяет ошибку, связанную с ячейкой электронной таблицы.

Формат записи:

Имя поля

Тип поля

Описание поля

type

Integer

Целочисленный код типа ошибки ячейки. Типы ошибок см. в официальном справочнике Google.

message

String

Описание ошибки.

Комментарий

Эта структура определяет комментарий, связанный с ячейкой электронной таблицы.

Формат записи:

Имя поля

Тип поля

Описание поля

comment

String

Текст комментария.

author

String

Автор комментария.

date

Дата

Дата добавления комментария.

Диапазон

Эта структура определяет прямоугольный диапазон ячеек в электронной таблице.

Формат записи:

Имя поля

Тип поля

Описание поля

startRowIndex

Integer

Индекс первой строки в диапазоне, начиная с нуля.

endRowIndex

Integer

Индекс последней строки в диапазоне, начиная с нуля.

startColumnIndex

Integer

Индекс первого столбца в диапазоне, начиная с нуля.

endColumnIndex

Integer

Индекс последнего столбца диапазона.

Группа

Эта структура определяет сгруппированный диапазон строк или столбцов.

Формат записи:

Имя поля

Тип поля

Описание поля

dimension

Integer

Измерение группы. Поддерживаемые значения:

  • 0 — Строка

  • 1 — Столбец.

startIndex

Integer

Начальный индекс группы.

endIndex

Integer

Конечный индекс группы.

collapsed

Boolean

Указывает, свернута ли группа.

depth

Integer

Уровень глубины группы.

Свойства измерения

Эта структура определяет метаданные строки или столбца.

Формат записи:

Имя поля

Тип поля

Описание поля

index

Integer

Индекс строки или столбца, начиная с нуля.

size

Integer

Высота строки или ширина столбца в пикселях.

hiddenByUser

Boolean

Если значение true, строка или столбец скрыты.

Диапазон измерений

Эта структура определяет диапазон строк или столбцов, используемый в операциях обновления измерений.

Формат записи:

Имя поля

Тип поля

Описание поля

dimension

Integer

Тип измерения. 0 для строк, 1 для колонок.

startIndex

Integer

Начинающийся с нуля индекс начала диапазона измерения.

endIndex

Integer

Конечный индекс диапазона измерений, начиная с нуля.

Условное форматирование

Эта структура определяет правило условного форматирования, используемое для изменения свойств выбранных ячеек при выполнении заданных условий. Правила условного форматирования хранятся как часть данных электронной таблицы в поле conditionalFormats Поле

Формат записи:

Имя поля

Тип поля

Описание поля

target

String

Атрибут целевого объекта, к которому применяется правило условного форматирования.

range

String

Диапазон ячеек (в нотации A1), к которому применяется правило условного форматирования.

condition

String

Условие, используемое для оценки правила.

expression

String

Выражение, определяющее правило условного форматирования.

Стиль элемента

Эта структура определяет кэшированные стили ячеек.

Формат записи:

Имя поля

Тип поля

Описание поля

id

Long

Уникальный идентификатор кэшированного стиля. 0 является стилем по умолчанию.

style

Data Table

Данные стиля ячейки (см. Стиль ячейки).

Форматы

Эта структура определяет кэшированные форматы ячеек.

Формат записи:

Имя поля

Тип поля

Описание поля

id

Long

Уникальный идентификатор кэшированного формата. 0 является форматированием по умолчанию.

format

String

Формат закодированной ячейки.

Параметр сортировки

Эта структура определяет параметры, используемые для сортировки данных в таблице.

Формат записи:

Имя поля

Тип поля

Описание поля

range

String

Диапазон ячеек, к которому применяется сортировка (в нотации A1).

column

String

Столбец, используемый для сортировки.

direction

Integer

Направление сортировки. Поддерживаемые значения:

0 — По убыванию

1 — По возрастанию.

Was this page helpful?