Cells

CellData

Данные о конкретной ячейке.

JSON-представление 
{
  "userEnteredValue": {
    object (ExtendedValue)
  },
  "effectiveValue": {
    object (ExtendedValue)
  },
  "formattedValue": string,
  "userEnteredFormat": {
    object (CellFormat)
  },
  "effectiveFormat": {
    object (CellFormat)
  },
  "hyperlink": string,
  "note": string,
  "textFormatRuns": [
    {
      object (TextFormatRun)
    }
  ],
  "dataValidation": {
    object (DataValidationRule)
  },
  "pivotTable": {
    object (PivotTable)
  },
  "dataSourceTable": {
    object (DataSourceTable)
  },
  "dataSourceFormula": {
    object (DataSourceFormula)
  }
}
Поля
userEnteredValue

object ( ExtendedValue )

Значение, введенное пользователем в ячейку. например, 1234 , 'Hello' или =NOW() Примечание. Даты, время и DateTimes представлены в виде двойных чисел в формате serial number .

effectiveValue

object ( ExtendedValue )

Эффективное значение ячейки. Для ячеек с формулами это расчетное значение. Для ячеек с литералами это то же самое, что и userEnteredValue. Это поле доступно только для чтения.

formattedValue

string

Отформатированное значение ячейки. Это значение, которое отображается пользователю. Это поле доступно только для чтения.

userEnteredFormat

object ( CellFormat )

Формат, введенный пользователем для ячейки.

При записи новый формат будет объединен с существующим форматом.

effectiveFormat

object ( CellFormat )

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

note

string

Любая заметка в ячейке.

textFormatRuns[]

object ( TextFormatRun )

Ряды форматированного текста, примененные к подразделам ячейки. Выполнение допустимо только для введенных пользователем строк, а не для формул, логических значений или чисел. Свойства запуска начинаются с определенного индекса в тексте и продолжаются до следующего запуска. Запуски будут наследовать свойства ячейки, если они не будут изменены явно.

При записи новые прогоны перезапишут все предыдущие прогоны. При записи нового userEnteredValue предыдущие прогоны стираются.

dataValidation

object ( DataValidationRule )

Правило проверки данных в ячейке, если таковое имеется.

При записи новое правило проверки данных перезапишет любое предыдущее правило.

pivotTable

object ( PivotTable )

Сводная таблица, привязанная к этой ячейке. Размер самой сводной таблицы вычисляется динамически на основе ее данных, группировки, фильтров, значений и т. д. Только верхняя левая ячейка сводной таблицы содержит определение сводной таблицы. Остальные ячейки будут содержать рассчитанные значения результатов сводной таблицы в полях effectiveValue .

dataSourceTable

object ( DataSourceTable )

Таблица источника данных, привязанная к этой ячейке. Размер самой таблицы источника данных вычисляется динамически на основе ее конфигурации. Только первая ячейка таблицы источника данных содержит определение таблицы источника данных. Остальные ячейки будут содержать отображаемые значения результата таблицы источника данных в полях effectiveValue .

dataSourceFormula

object ( DataSourceFormula )

Только вывод. Информация о формуле источника данных в ячейке. Поле устанавливается, если userEnteredValue представляет собой формулу, ссылающуюся на какой-либо лист DATA_SOURCE , например =SUM(DataSheet!Column) .

Формат ячейки

Формат ячейки.

JSON-представление 
{
  "numberFormat": {
    object (NumberFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "borders": {
    object (Borders)
  },
  "padding": {
    object (Padding)
  },
  "horizontalAlignment": enum (HorizontalAlign),
  "verticalAlignment": enum (VerticalAlign),
  "wrapStrategy": enum (WrapStrategy),
  "textDirection": enum (TextDirection),
  "textFormat": {
    object (TextFormat)
  },
  "hyperlinkDisplayType": enum (HyperlinkDisplayType),
  "textRotation": {
    object (TextRotation)
  }
}
Поля
numberFormat

object ( NumberFormat )

Формат, описывающий, как числовые значения должны быть представлены пользователю.

backgroundColor
(deprecated)

object ( Color )

Цвет фона ячейки. Устарело: используйте backgroundColorStyle .

backgroundColorStyle

object ( ColorStyle )

Цвет фона ячейки. Если также установлен backgroundColor , это поле имеет приоритет.

borders

object ( Borders )

Границы ячейки.

padding

object ( Padding )

Заполнение ячейки.

horizontalAlignment

enum ( HorizontalAlign )

Горизонтальное выравнивание значения в ячейке.

verticalAlignment

enum ( VerticalAlign )

Вертикальное выравнивание значения в ячейке.

wrapStrategy

enum ( WrapStrategy )

Стратегия переноса значения в ячейке.

textDirection

enum ( TextDirection )

Направление текста в ячейке.

textFormat

object ( TextFormat )

Формат текста в ячейке (если не переопределен при запуске формата). Установка здесь ссылки на уровне ячейки удаляет существующие связи ячейки. Установка поля ссылки в TextFormatRun имеет приоритет над ссылкой на уровне ячейки.

textRotation

object ( TextRotation )

Поворот применяется к тексту в ячейке.

Числовой формат

Числовой формат ячейки.

JSON-представление 
{
  "type": enum (NumberFormatType),
  "pattern": string
}
Поля
type

enum ( NumberFormatType )

Тип числового формата. При написании это поле должно быть задано.

pattern

string

Строка шаблона, используемая для форматирования. Если этот параметр не установлен, при необходимости для данного типа будет использоваться шаблон по умолчанию, основанный на языковом стандарте пользователя. Дополнительную информацию о поддерживаемых шаблонах см. в руководстве по форматам дат и чисел .

НомерФорматТип

Числовой формат ячейки. В этой документации предполагается, что локаль — 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 (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}
Поля
top

object ( Border )

Верхняя граница ячейки.

bottom

object ( Border )

Нижняя граница ячейки.

left

object ( Border )

Левая граница ячейки.

right

object ( Border )

Правая граница ячейки.

Граница

Граница вдоль ячейки.

JSON-представление 
{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Поля
style

enum ( Style )

Стиль границы.

width
(deprecated)

integer

Ширина границы в пикселях. Устарело; ширина определяется полем «стиль».

color
(deprecated)

object ( Color )

Цвет границы. Устарело: используйте colorStyle .

colorStyle

object ( ColorStyle )

Цвет границы. Если также задан color , это поле имеет приоритет.

Стиль

Стиль границы.

Перечисления
STYLE_UNSPECIFIED Стиль не указан. Не используйте это.
DOTTED Граница пунктирная.
DASHED Граница пунктирная.
SOLID Граница представляет собой тонкую сплошную линию.
SOLID_MEDIUM Граница представляет собой среднюю сплошную линию.
SOLID_THICK Граница представляет собой толстую сплошную линию.
NONE Нет границы. Используется только при обновлении границы с целью ее стирания.
DOUBLE Граница представляет собой две сплошные линии.

Заполнение

Размер заполнения вокруг ячейки в пикселях. При обновлении заполнения необходимо указать каждое поле.

JSON-представление 
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
Поля
top

integer

Верхнее дополнение ячейки.

right

integer

Правильное заполнение ячейки.

bottom

integer

Нижнее дополнение ячейки.

left

integer

Левое дополнение ячейки.

Вертикальное выравнивание

Вертикальное выравнивание текста в ячейке.

Перечисления
VERTICAL_ALIGN_UNSPECIFIED Вертикальное выравнивание не указано. Не используйте это.
TOP Текст явно выравнивается по верху ячейки.
MIDDLE Текст явно выравнивается по середине ячейки.
BOTTOM Текст явно выравнивается по нижнему краю ячейки.

WrapСтратегия

Как переносить текст в ячейке.

Перечисления
WRAP_STRATEGY_UNSPECIFIED Значение по умолчанию, не использовать.
OVERFLOW_CELL

Строки, длина которых превышает ширину ячейки, будут записаны в следующую ячейку, если эта ячейка пуста. Если следующая ячейка не пуста, это ведет себя так же, как CLIP . Текст никогда не перенесется на следующую строку, если пользователь вручную не вставит новую строку. Пример:

| First sentence. |
| Manual newline that is very long. <- Text continues into next cell
| Next newline.   |
LEGACY_WRAP

Эта стратегия переноса представляет собой старую стратегию переноса Google Таблиц, при которой слова, длина которых превышает строку, обрезаются, а не разрываются. Эта стратегия поддерживается не на всех платформах и постепенно прекращается. Пример:

| Cell has a |
| loooooooooo| <- Word is clipped.
| word.      |
CLIP

Линии, длина которых превышает ширину ячейки, будут обрезаны. Текст никогда не перенесется на следующую строку, если пользователь вручную не вставит новую строку. Пример:

| First sentence. |
| Manual newline t| <- Text is clipped
| Next newline.   |
WRAP

Слова длиннее строки переносятся на уровне символов, а не обрезаются. Пример: 

| Cell has a |
| loooooooooo| <- Word is broken.
| ong word.  |

Текстдиректион

Направление текста в ячейке.

Перечисления
TEXT_DIRECTION_UNSPECIFIED Направление текста не указано. Не используйте это.
LEFT_TO_RIGHT Направление текста слева направо задается пользователем.
RIGHT_TO_LEFT Направление текста справа налево задается пользователем.

ГиперссылкаDisplayType

Следует ли явно отображать гиперссылку. Если не указано, гиперссылка является связанной.

Перечисления
LINKED Гиперссылка должна отображаться явно.
PLAIN_TEXT Гиперссылка не должна отображаться.

ТекстРотация

Поворот применяется к тексту в ячейке.

JSON-представление 
{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}
Поля
type поля объединения. Тип вращения: вертикальный или угловой. type может быть только одним из следующих:
angle

integer

Угол между стандартной ориентацией и желаемой ориентацией. Измеряется в градусах. Допустимые значения: от -90 до 90. Положительные углы наклонены вверх, отрицательные — вниз.

Примечание. Для направления текста LTR положительные углы располагаются против часовой стрелки, а для RTL — по часовой стрелке.

vertical

boolean

Если это правда, текст читается сверху вниз, но ориентация отдельных символов не меняется. Например: 

| V |
| e |
| r |
| t |
| i |
| c |
| a |
| l |

ТекстФорматВыполнить

Прогон текстового формата. Формат этого прогона продолжается до тех пор, пока не будет достигнут индекс начала следующего прогона. При обновлении все поля должны быть заданы.

JSON-представление 
{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}
Поля
startIndex

integer

Индекс символов, отсчитываемый от нуля, в котором начинается этот запуск, в кодовых единицах UTF-16.

format

object ( TextFormat )

Формат этого забега. Отсутствующие значения наследуют формат ячейки.

Правило проверки данных

Правило проверки данных.

JSON-представление 
{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
Поля
condition

object ( BooleanCondition )

Условие соответствия данных в ячейке.

inputMessage

string

Сообщение, отображаемое пользователю при добавлении данных в ячейку.

strict

boolean

True, если недействительные данные должны быть отклонены.

showCustomUi

boolean

Истинно, если пользовательский интерфейс должен быть настроен в зависимости от типа условия. Если это правда, условия «Списка» отобразят раскрывающийся список.

Таблица источника данных

Таблица источника данных, которая позволяет пользователю импортировать статическую таблицу данных из DataSource в Таблицы. В редакторе Таблиц это также называется «Извлечение».

JSON-представление 
{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Поля
dataSourceId

string

Идентификатор источника данных, с которым связана таблица источника данных.

columnSelectionType

enum ( DataSourceTableColumnSelectionType )

Тип для выбора столбцов для таблицы источника данных. По умолчанию SELECTED .

columns[]

object ( DataSourceColumnReference )

Столбцы, выбранные для таблицы источника данных. columnSelectionType должен быть SELECTED .

filterSpecs[]

object ( FilterSpec )

Спецификации фильтра в таблице источника данных.

sortSpecs[]

object ( SortSpec )

Спецификации сортировки в таблице источника данных. Результат таблицы источника данных сортируется на основе спецификаций сортировки по порядку.

rowLimit

integer

Предел возвращаемых строк. Если не установлено, применяется ограничение по умолчанию. Пожалуйста, обратитесь к редактору Таблиц, чтобы узнать значения по умолчанию и максимальный лимит.

dataExecutionStatus

object ( DataExecutionStatus )

Только вывод. Статус выполнения данных.

DataSourceTableColumnSelectionType

Типы выбора столбца таблицы источника данных.

Перечисления
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Тип выбора столбца по умолчанию, не используйте.
SELECTED Выберите столбцы, указанные в поле columns .
SYNC_ALL

Синхронизируйте все текущие и будущие столбцы в источнике данных.

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

Формула Источника Данных

Формула источника данных.

JSON-представление 
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Поля
dataSourceId

string

Идентификатор источника данных, с которым связана формула.

dataExecutionStatus

object ( DataExecutionStatus )

Только вывод. Статус выполнения данных.