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() Примечание. Даты, время и время и дата представлены в виде двойных чисел в формате 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 Sheets, когда слова, которые длиннее строки, обрезаются, а не разрываются. Эта стратегия поддерживается не на всех платформах и постепенно прекращается. Пример:

| 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.  |

TextDirection

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

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

HyperlinkDisplayType

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

перечисления
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

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

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

TextFormatRun

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

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

integer

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

format

object ( TextFormat )

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

DataValidationRule

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

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

object ( BooleanCondition )

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

inputMessage

string

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

strict

boolean

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

showCustomUi

boolean

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

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

Таблица источника данных, которая позволяет пользователю импортировать статическую таблицу данных из 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 )

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