CellData
Данные о конкретной ячейке.
Представление JSON |
---|
{ "userEnteredValue": { object ( |
Поля | |
---|---|
userEnteredValue | Значение, которое пользователь ввел в ячейку. например, |
effectiveValue | Эффективное значение ячейки. Для ячеек с формулами это расчетное значение. Для ячеек с литералами это то же самое, что и userEnteredValue. Это поле доступно только для чтения. |
formattedValue | Отформатированное значение ячейки. Это значение, которое отображается пользователю. Это поле доступно только для чтения. |
userEnteredFormat | Формат, введенный пользователем для ячейки. При записи новый формат будет объединен с существующим форматом. |
effectiveFormat | Эффективный формат, используемый ячейкой. Сюда входят результаты применения любого условного форматирования и, если ячейка содержит формулу, формат вычисляемого числа. Если эффективный формат является форматом по умолчанию, эффективный формат не будет записан. Это поле доступно только для чтения. |
hyperlink | Гиперссылка, на которую указывает эта ячейка, если таковая имеется. Если ячейка содержит несколько гиперссылок, это поле будет пустым. Это поле доступно только для чтения. Чтобы установить его, используйте формулу |
note | Любая заметка на сотовый. |
textFormatRuns[] | Прогоны форматированного текста применяются к подразделам ячейки. Запуски допустимы только для введенных пользователем строк, а не для формул, логических значений или чисел. Свойства запуска начинаются с определенного индекса в тексте и продолжаются до следующего запуска. Прогоны будут наследовать свойства ячейки, если они явно не изменены. При записи новые прогоны перезаписывают все предыдущие прогоны. При записи нового |
dataValidation | Правило проверки данных в ячейке, если оно есть. При записи новое правило проверки данных перезапишет любое предыдущее правило. |
pivotTable | Сводная таблица, привязанная к этой ячейке. Размер самой сводной таблицы вычисляется динамически на основе ее данных, группировки, фильтров, значений и т. д. Только верхняя левая ячейка сводной таблицы содержит определение сводной таблицы. Другие ячейки будут содержать рассчитанные значения результатов сводки в своих полях |
dataSourceTable | Таблица источника данных, привязанная к этой ячейке. Размер самой таблицы источника данных вычисляется динамически на основе ее конфигурации. Только первая ячейка таблицы источника данных содержит определение таблицы источника данных. Другие ячейки будут содержать отображаемые значения таблицы источника данных в их полях |
dataSourceFormula | Только вывод. Информация о формуле источника данных в ячейке. Поле устанавливается, если |
Формат ячейки
Формат ячейки.
Представление JSON |
---|
{ "numberFormat": { object ( |
Поля | |
---|---|
numberFormat | Формат, описывающий, как числовые значения должны быть представлены пользователю. |
backgroundColor | Цвет фона ячейки. Устарело: используйте |
backgroundColorStyle | Цвет фона ячейки. Если также установлен |
borders | Границы клетки. |
padding | Заполнение ячейки. |
horizontalAlignment | Горизонтальное выравнивание значения в ячейке. |
verticalAlignment | Вертикальное выравнивание значения в ячейке. |
wrapStrategy | Стратегия переноса значения в ячейке. |
textDirection | Направление текста в ячейке. |
textFormat | Формат текста в ячейке (если он не переопределен форматированием). Установка здесь ссылки на уровне ячейки очищает существующие ссылки ячейки. Установка поля ссылки в |
hyperlinkDisplayType | Если он существует, то как гиперссылка должна отображаться в ячейке. |
textRotation | Поворот применяется к тексту в ячейке. |
Формат номера
Числовой формат ячейки.
Представление JSON |
---|
{
"type": enum ( |
Поля | |
---|---|
type | Тип числового формата. При записи это поле должно быть установлено. |
pattern | Строка шаблона, используемая для форматирования. Если не задано, при необходимости для данного типа будет использоваться шаблон по умолчанию, основанный на локали пользователя. Дополнительные сведения о поддерживаемых шаблонах см. в руководстве по формату даты и числа . |
НомерФорматТип
Числовой формат ячейки. В этой документации предполагается, что языковой стандарт — en_US, но фактический формат зависит от языкового стандарта электронной таблицы.
перечисления | |
---|---|
NUMBER_FORMAT_TYPE_UNSPECIFIED | Формат числа не указан и основан на содержимом ячейки. Не используйте это явно. |
TEXT | Форматирование текста, например 1000.12 |
NUMBER | Форматирование чисел, например, 1,000.12 |
PERCENT | Процентное форматирование, например 10.12% |
CURRENCY | Форматирование валюты, например $1,000.12 |
DATE | Форматирование даты, например 9/26/2008 |
TIME | Форматирование времени, например 3:59:00 PM |
DATE_TIME | Форматирование даты и времени, например 9/26/08 15:59:00 |
SCIENTIFIC | Форматирование научного числа, например 1.01E+03 |
Границы
Границы клетки.
Представление JSON |
---|
{ "top": { object ( |
Поля | |
---|---|
top | Верхняя граница ячейки. |
bottom | Нижняя граница ячейки. |
left | Левая граница ячейки. |
right | Правая граница ячейки. |
Граница
Граница вдоль ячейки.
Представление JSON |
---|
{ "style": enum ( |
Поля | |
---|---|
style | Стиль границы. |
width | Ширина границы в пикселях. Устарело; ширина определяется полем «стиль». |
color | Цвет границы. Устарело: используйте |
colorStyle | Цвет границы. Если также задан |
Стиль
Стиль границы.
перечисления | |
---|---|
STYLE_UNSPECIFIED | Стиль не указан. Не используйте это. |
DOTTED | Граница пунктирная. |
DASHED | Граница штрихована. |
SOLID | Граница – тонкая сплошная линия. |
SOLID_MEDIUM | Граница представляет собой среднюю сплошную линию. |
SOLID_THICK | Граница представляет собой толстую сплошную линию. |
NONE | Без границ. Используется только при обновлении границы с целью ее стирания. |
DOUBLE | Граница – две сплошные линии. |
Прокладка
Количество отступов вокруг ячейки в пикселях. При обновлении заполнения каждое поле должно быть указано.
Представление JSON |
---|
{ "top": integer, "right": integer, "bottom": integer, "left": integer } |
Поля | |
---|---|
top | Верхнее заполнение ячейки. |
right | Правое заполнение ячейки. |
bottom | Нижний отступ ячейки. |
left | Левое заполнение ячейки. |
Вертикальное выравнивание
Вертикальное выравнивание текста в ячейке.
перечисления | |
---|---|
VERTICAL_ALIGN_UNSPECIFIED | Вертикальное выравнивание не указано. Не используйте это. |
TOP | Текст явно выравнивается по верхнему краю ячейки. |
MIDDLE | Текст явно выравнивается по середине ячейки. |
BOTTOM | Текст явно выравнивается по нижнему краю ячейки. |
WrapСтратегии
Как обтекать текст в ячейке.
перечисления | |
---|---|
WRAP_STRATEGY_UNSPECIFIED | Значение по умолчанию, не использовать. |
OVERFLOW_CELL | Строки, длина которых превышает ширину ячейки, будут записаны в следующей ячейке, если эта ячейка пуста. Если следующая ячейка не пуста, это ведет себя так же, как
|
LEGACY_WRAP | Эта стратегия переноса представляет собой старую стратегию переноса Google Sheets, когда слова, которые длиннее строки, обрезаются, а не разрываются. Эта стратегия поддерживается не на всех платформах и постепенно прекращается. Пример:
|
CLIP | Линии, длина которых превышает ширину ячейки, будут обрезаны. Текст никогда не будет перенесен на следующую строку, если только пользователь не вставит новую строку вручную. Пример:
|
WRAP | Слова, которые длиннее строки, переносятся на уровне символов, а не обрезаются. Пример:
|
TextDirection
Направление текста в ячейке.
перечисления | |
---|---|
TEXT_DIRECTION_UNSPECIFIED | Направление текста не указано. Не используйте это. |
LEFT_TO_RIGHT | Направление текста слева направо задается пользователем. |
RIGHT_TO_LEFT | Направление текста справа налево было установлено пользователем. |
HyperlinkDisplayType
Следует ли явно отображать гиперссылку. Если не указано, гиперссылка является ссылкой.
перечисления | |
---|---|
HYPERLINK_DISPLAY_TYPE_UNSPECIFIED | Значение по умолчанию: отображается гиперссылка. Не используйте это. |
LINKED | Гиперссылка должна отображаться явно. |
PLAIN_TEXT | Гиперссылка не должна отображаться. |
Поворот текста
Поворот применяется к тексту в ячейке.
Представление JSON |
---|
{ // Union field |
Поля | |
---|---|
type поля объединения. Тип вращения, вертикальный или угловой. type может быть только одним из следующих: | |
angle | Угол между стандартной ориентацией и желаемой ориентацией. Измеряется в градусах. Допустимые значения находятся в диапазоне от -90 до 90. Положительные углы направлены вверх, отрицательные — вниз. Примечание. Для направления текста LTR положительные углы отсчитываются против часовой стрелки, а для RTL — по часовой стрелке. |
vertical | Если true, текст читается сверху вниз, но ориентация отдельных символов не изменяется. Например:
|
TextFormatRun
Прогон текстового формата. Формат этого прогона продолжается до начального индекса следующего прогона. При обновлении все поля должны быть установлены.
Представление JSON |
---|
{
"startIndex": integer,
"format": {
object ( |
Поля | |
---|---|
startIndex | Отсчитываемый от нуля индекс символов, с которого начинается этот запуск, в кодовых единицах UTF-16. |
format | Формат этого запуска. Отсутствующие значения наследуют формат ячейки. |
DataValidationRule
Правило проверки данных.
Представление JSON |
---|
{
"condition": {
object ( |
Поля | |
---|---|
condition | Условие, при котором данные в ячейке должны совпадать. |
inputMessage | Сообщение для отображения пользователю при добавлении данных в ячейку. |
strict | Истинно, если неверные данные должны быть отклонены. |
showCustomUi | True, если пользовательский интерфейс должен быть настроен в зависимости от типа условия. Если true, условия «Список» отобразят раскрывающийся список. |
Таблица источника данных
Таблица источника данных, которая позволяет пользователю импортировать статическую таблицу данных из DataSource
в Таблицы. Это также известно как «Извлечение» в редакторе листов.
Представление JSON |
---|
{ "dataSourceId": string, "columnSelectionType": enum ( |
Поля | |
---|---|
dataSourceId | Идентификатор источника данных, с которым связана таблица источника данных. |
columnSelectionType | Тип для выбора столбцов для таблицы источника данных. По умолчанию |
columns[] | Столбцы, выбранные для таблицы источника данных. |
filterSpecs[] | Характеристики фильтра в таблице источника данных. |
sortSpecs[] | Сортировка спецификаций в таблице источника данных. Результат таблицы источника данных сортируется на основе спецификаций сортировки по порядку. |
rowLimit | Предел возвращаемых строк. Если не задано, применяется ограничение по умолчанию. Пожалуйста, обратитесь к редактору Таблиц, чтобы узнать максимальное и максимальное ограничения. |
dataExecutionStatus | Только вывод. Статус выполнения данных. |
DataSourceTableColumnSelectionType
Типы выбора столбца таблицы источника данных.
перечисления | |
---|---|
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED | Тип выбора столбца по умолчанию, не использовать. |
SELECTED | Выберите столбцы, указанные в поле columns . |
SYNC_ALL | Синхронизируйте все текущие и будущие столбцы в источнике данных. Если установлено, таблица источника данных извлекает все столбцы в источнике данных во время обновления. |
Источник данныхФормула
Формула источника данных.
Представление JSON |
---|
{
"dataSourceId": string,
"dataExecutionStatus": {
object ( |
Поля | |
---|---|
dataSourceId | Идентификатор источника данных, с которым связана формула. |
dataExecutionStatus | Только вывод. Статус выполнения данных. |