Sheets

Лист

Лист в электронной таблице.

JSON-представление
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ],
  "tables": [
    {
      object (Table)
    }
  ]
}
Поля
properties

object ( SheetProperties )

Свойства листа.

data[]

object ( GridData )

Данные в таблице, если это табличный лист.

Количество возвращаемых объектов GridData зависит от количества запрошенных диапазонов на этом листе. Например, если это лист Sheet1 , и электронная таблица была запрошена с диапазонами Sheet1!A1:C10 и Sheet1!D15:E20 , то первый объект GridData будет иметь startRow / startColumn равные 0 , а второй — startRow 14 (строка 15 с нулевой индексацией) и startColumn 3 (столбец D с нулевой индексацией).

Для листа DATA_SOURCE нельзя запросить конкретный диапазон значений, GridData содержит все значения.

merges[]

object ( GridRange )

Диапазоны, которые объединяются.

conditionalFormats[]

object ( ConditionalFormatRule )

Правила условного форматирования в этом листе.

filterViews[]

object ( FilterView )

Представления фильтров в этом листе.

protectedRanges[]

object ( ProtectedRange )

Защищенные участки указаны в этом листе.

basicFilter

object ( BasicFilter )

Фильтр на этом листе, если таковой имеется.

charts[]

object ( EmbeddedChart )

Технические характеристики каждой диаграммы на этом листе.

bandedRanges[]

object ( BandedRange )

На этом листе представлены полосы (чередующиеся цвета).

developerMetadata[]

object ( DeveloperMetadata )

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

rowGroups[]

object ( DimensionGroup )

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

columnGroups[]

object ( DimensionGroup )

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

slicers[]

object ( Slicer )

На этом листе расположены слайсеры.

tables[]

object ( Table )

Таблицы на этом листе.

Свойства листа

Свойства листа.

JSON-представление
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
Поля
sheetId

integer

Идентификатор листа. Должно быть неотрицательным. После установки значение в этом поле изменить нельзя.

title

string

Название листа.

index

integer

Индекс листа в электронной таблице. При добавлении или обновлении свойств листа, если это поле исключено, лист добавляется или перемещается в конец списка листов. При обновлении индексов листов или вставке листов перемещение учитывается в индексах «до перемещения». Например, если есть три листа (S1, S2, S3), то для перемещения S1 вперед S2 индекс необходимо установить равным 2. Запрос на обновление индекса листа игнорируется, если запрашиваемый индекс идентичен текущему индексу листа или если запрашиваемый новый индекс равен текущему индексу листа + 1.

sheetType

enum ( SheetType )

Тип листа. По умолчанию — GRID . Это поле нельзя изменить после установки значения.

gridProperties

object ( GridProperties )

Дополнительные свойства листа, если этот лист является сеткой. (Если лист является объектным, содержащим диаграмму или изображение, то это поле будет отсутствовать.) При записи некорректно задавать какие-либо свойства сетки на листах, не являющихся сеткой.

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

hidden

boolean

Значение true, если лист скрыт в пользовательском интерфейсе, false, если он виден.

tabColor
(deprecated)

object ( Color )

Цвет вкладки в пользовательском интерфейсе. Устарело: используйте tabColorStyle .

tabColorStyle

object ( ColorStyle )

Цвет вкладки в пользовательском интерфейсе. Если также задан параметр tabColor , приоритет имеет это поле.

rightToLeft

boolean

Возвращает true, если лист имеет формат RTL (справа налево), а не LTR (слева направо).

dataSourceSheetProperties

object ( DataSourceSheetProperties )

Только для вывода. Если поле присутствует, оно содержит свойства, специфичные для листа DATA_SOURCE .

Тип листа

Тип простыни.

Перечисления
SHEET_TYPE_UNSPECIFIED Значение по умолчанию, не использовать.
GRID Лист представляет собой сетку.
OBJECT В таблице нет сетки, вместо этого она содержит объект, например, диаграмму или изображение.
DATA_SOURCE Этот лист подключается к внешнему DataSource и отображает предварительный просмотр данных.

GridProperties

Свойства сетки.

JSON-представление
{
  "rowCount": integer,
  "columnCount": integer,
  "frozenRowCount": integer,
  "frozenColumnCount": integer,
  "hideGridlines": boolean,
  "rowGroupControlAfter": boolean,
  "columnGroupControlAfter": boolean
}
Поля
rowCount

integer

Количество строк в сетке.

columnCount

integer

Количество столбцов в сетке.

frozenRowCount

integer

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

frozenColumnCount

integer

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

hideGridlines

boolean

Возвращает true, если в пользовательском интерфейсе не отображаются линии сетки.

rowGroupControlAfter

boolean

Значение true, если переключатель управления группировкой строк отображается после группы.

columnGroupControlAfter

boolean

Значение true, если переключатель управления группировкой столбцов отображается после группы.

DataSourceSheetProperties

Дополнительные свойства листа DATA_SOURCE .

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

string

Идентификатор источника DataSource , к которому подключен лист.

columns[]

object ( DataSourceColumn )

Столбцы, отображаемые на листе, соответствуют значениям в RowData .

dataExecutionStatus

object ( DataExecutionStatus )

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

GridData

Данные в таблице, а также метаданные об измерениях.

JSON-представление
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
Поля
startRow

integer

Первая строка, на которую ссылается этот GridData, начинается с нуля.

startColumn

integer

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

rowData[]

object ( RowData )

Данные в таблице, по одной записи в каждой строке, начиная со строки в переменной startRow. Значения в переменной RowData будут соответствовать столбцам, начиная со startColumn .

rowMetadata[]

object ( DimensionProperties )

Метаданные о запрошенных строках в сетке, начиная со строки в startRow .

columnMetadata[]

object ( DimensionProperties )

Метаданные о запрошенных столбцах в таблице, начиная со столбца в startColumn .

RowData

Данные о каждой ячейке в строке.

JSON-представление
{
  "values": [
    {
      object (CellData)
    }
  ]
}
Поля
values[]

object ( CellData )

Значения в строке, по одному в каждом столбце.

DimensionProperties

Свойства, относящиеся к измерению.

JSON-представление
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
Поля
hiddenByFilter

boolean

Значение true, если выполняется фильтрация по этому параметру. Это поле доступно только для чтения.

hiddenByUser

boolean

Истина, если это измерение явно скрыто.

pixelSize

integer

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

developerMetadata[]

object ( DeveloperMetadata )

Метаданные разработчика, связанные с отдельной строкой или столбцом.

dataSourceColumnReference

object ( DataSourceColumnReference )

Только для вывода. Если задано, это столбец в листе источника данных.

ConditionalFormatRule

Правило, описывающее условное форматирование.

JSON-представление
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
Поля
ranges[]

object ( GridRange )

Диапазоны, форматируемые при выполнении условия. Все диапазоны должны находиться в одной сетке.

rule объединения полей. Правило, управляющее этим условным форматированием, должно быть установлено ровно одно. rule может быть только одним из следующих:
booleanRule

object ( BooleanRule )

Форматирование либо включено, либо выключено в соответствии с правилом.

gradientRule

object ( GradientRule )

Форматирование будет меняться в зависимости от градиентов в разметке.

Логическое правило

Правило, которое может совпадать, а может и не совпадать в зависимости от условий.

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

object ( BooleanCondition )

Условие правила. Если условие истинно, применяется указанный формат.

format

object ( CellFormat )

Применяемый формат. Условное форматирование может применять только подмножество форматирования: bold , italic , strikethrough , foreground color и background color .

GradientRule

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

JSON-представление
{
  "minpoint": {
    object (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
Поля
minpoint

object ( InterpolationPoint )

Начальная точка интерполяции.

midpoint

object ( InterpolationPoint )

Дополнительная промежуточная точка интерполяции.

maxpoint

object ( InterpolationPoint )

Последняя точка интерполяции.

Точка интерполяции

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

JSON-представление
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
Поля
color
(deprecated)

object ( Color )

Цвет, который должна использовать эта точка интерполяции. Устарело: используйте colorStyle .

colorStyle

object ( ColorStyle )

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

type

enum ( InterpolationPointType )

Как следует интерпретировать это значение.

value

string

Значение, используемое в данной точке интерполяции. Может быть формулой. Не используется, если typeMIN или MAX .

InterpolationPointType

Тип точки интерполяции.

Перечисления
INTERPOLATION_POINT_TYPE_UNSPECIFIED Значение по умолчанию не использовать.
MIN В качестве точки интерполяции используется минимальное значение в ячейках в диапазоне условного формата.
MAX В качестве точки интерполяции используется максимальное значение в ячейках в диапазоне условного формата.
NUMBER Точка интерполяции использует в точности значение из InterpolationPoint.value .
PERCENT

Точка интерполяции — это заданный процент по всем ячейкам в диапазоне условного формата. Это эквивалентно NUMBER , если значение было: =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) (где ошибки в диапазоне игнорируются при сглаживании).

PERCENTILE Точка интерполяции — это заданный процентиль по всем ячейкам в диапазоне условного формата. Это эквивалентно NUMBER , если значение было: =PERCENTILE(FLATTEN(range), value / 100) (где ошибки в диапазоне игнорируются при сглаживании).

ФильтрВид

Представление с фильтрами. Дополнительную информацию см. в разделе «Управление видимостью данных с помощью фильтров» .

JSON-представление
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Поля
filterViewId

integer

Идентификатор представления фильтра.

title

string

Название представления фильтра.

range

object ( GridRange )

Диапазон, охватываемый данным фильтром.

При записи можно задать только один из параметров: range , namedRangeId или tableId .

namedRangeId

string

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

При записи можно задать только один из параметров: range , namedRangeId или tableId .

tableId

string

Если таковая имеется, то какой таблицей поддерживается данный фильтр.

При записи можно задать только один из параметров: range , namedRangeId или tableId .

sortSpecs[]

object ( SortSpec )

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

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria ))

Критерии для отображения/скрытия значений по столбцам. Ключом карты является индекс столбца, а значением — критерий для этого столбца.

Это поле устарело и заменено на filterSpecs .

filterSpecs[]

object ( FilterSpec )

Критерии фильтрации для отображения или скрытия значений в каждом столбце.

В ответах заполняются как criteria , так и filterSpecs . Если в запросе на обновление указаны оба поля, приоритет имеет это поле.

Защищенный полигон

Охраняемая территория.

JSON-представление
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
Поля
protectedRangeId

integer

Идентификатор защищаемого диапазона. Это поле доступно только для чтения.

range

object ( GridRange )

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

При записи можно задать только один из параметров: range , namedRangeId или tableId .

namedRangeId

string

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

При записи можно задать только один из параметров: range , namedRangeId или tableId .

tableId

string

Таблица, на которую распространяется действие данного защищенного диапазона, если таковая имеется.

При записи можно задать только один из параметров: range , namedRangeId или tableId .

description

string

Описание данной охраняемой территории.

warningOnly

boolean

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

При написании: если это поле имеет значение true, то editors игнорируются. Кроме того, если это поле изменено с true на false, а поле editors не задано (и не включено в маску поля), то редакторы будут установлены для всех редакторов в документе.

requestingUserCanEdit

boolean

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

unprotectedRanges[]

object ( GridRange )

Список незащищенных диапазонов внутри защищенного листа. Незащищенные диапазоны поддерживаются только на защищенных листах.

editors

object ( Editors )

Пользователи и группы, имеющие доступ к редактированию защищенного диапазона. Это поле видно только пользователям, имеющим доступ к редактированию защищенного диапазона и документа. Редакторы не поддерживаются при использовании защиты warningOnly .

Редакторы

Редакторы охраняемой территории.

JSON-представление
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
Поля
users[]

string

Адреса электронной почты пользователей, имеющих права на редактирование защищенного диапазона.

groups[]

string

Адреса электронной почты групп, имеющих права на редактирование защищенного диапазона.

domainUsersCanEdit

boolean

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

Базовый фильтр

Фильтр по умолчанию, связанный с листом. Дополнительную информацию см. в разделе «Управление видимостью данных с помощью фильтров» .

JSON-представление
{
  "range": {
    object (GridRange)
  },
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Поля
range

object ( GridRange )

Диапазон действия фильтра.

tableId

string

Если таковая имеется, укажите таблицу, на основе которой работает этот фильтр. При записи можно задать только один из параметров: range или tableId .

sortSpecs[]

object ( SortSpec )

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

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria ))

Критерии для отображения/скрытия значений по столбцам. Ключом карты является индекс столбца, а значением — критерий для этого столбца.

Это поле устарело и заменено на filterSpecs .

filterSpecs[]

object ( FilterSpec )

Критерии фильтрации для каждого столбца.

В ответах заполняются как criteria , так и filterSpecs . Если в запросе на обновление указаны оба поля, приоритет имеет это поле.

BandedRange

На листе представлена ​​полосатая (чередующаяся) цветовая гамма.

JSON-представление
{
  "bandedRangeId": integer,
  "bandedRangeReference": string,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
Поля
bandedRangeId

integer

Идентификатор диапазона, ограниченного полосами. Если не задан, обратитесь к параметру bandedRangeReference .

bandedRangeReference

string

Только для вывода. Ссылка на диапазон полос, используемая для идентификации идентификатора, который не поддерживается параметром bandedRangeId .

range

object ( GridRange )

Диапазон, в котором применяются эти свойства.

rowProperties

object ( BandingProperties )

Свойства для полос строк. Эти свойства применяются построчно ко всем строкам в диапазоне. Необходимо указать хотя бы одно из rowProperties или columnProperties .

columnProperties

object ( BandingProperties )

Свойства для полос столбцов. Эти свойства применяются к каждому столбцу отдельно для всех столбцов в диапазоне. Необходимо указать хотя бы одно из rowProperties или columnProperties .

BandingProperties

Свойства относятся к одному измерению (строке или столбцу). Если заданы параметры BandedRange.row_properties и BandedRange.column_properties , цвета заливки ячеек применяются в соответствии со следующими правилами:

Например, цвет первой строки имеет приоритет над цветом первого столбца, но цвет первого столбца имеет приоритет над цветом второй строки. Аналогично, заголовок строки имеет приоритет над заголовком столбца в ячейке в верхнем левом углу, но заголовок столбца имеет приоритет над цветом первой строки, если заголовок строки не задан.

JSON-представление
{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Поля
headerColor
(deprecated)

object ( Color )

Цвет первой строки или столбца. Если это поле задано, первая строка или столбец заполняется этим цветом, и цвета чередуются между firstBandColor и secondBandColor начиная со второй строки или столбца. В противном случае первая строка или столбец заполняется цветом firstBandColor , и цвета продолжают чередоваться, как обычно. Устарело: используйте headerColorStyle .

headerColorStyle

object ( ColorStyle )

Цвет первой строки или столбца. Если это поле задано, первая строка или столбец заполняется этим цветом, и цвета чередуются между firstBandColor и secondBandColor начиная со второй строки или столбца. В противном случае первая строка или столбец заполняется цветом firstBandColor , и цвета продолжают чередоваться, как обычно. Если также задан headerColor , это поле имеет приоритет.

firstBandColor
(deprecated)

object ( Color )

Первый чередующийся цвет. (Обязательно) Устарело: используйте firstBandColorStyle .

firstBandColorStyle

object ( ColorStyle )

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

secondBandColor
(deprecated)

object ( Color )

Второй чередующийся цвет. (Обязательно) Устарело: используйте secondBandColorStyle .

secondBandColorStyle

object ( ColorStyle )

Второй чередующийся цвет. (Обязательно) Если также задан параметр secondBandColor , приоритет имеет это поле.

footerColor
(deprecated)

object ( Color )

Цвет последней строки или столбца. Если это поле не задано, последняя строка или столбец заполняется либо цветом firstBandColor , либо secondBandColor в зависимости от цвета предыдущей строки или столбца. Устарело: используйте footerColorStyle .

footerColorStyle

object ( ColorStyle )

Цвет последней строки или столбца. Если это поле не задано, последняя строка или столбец заполняется либо цветом firstBandColor , либо secondBandColor в зависимости от цвета предыдущей строки или столбца. Если также задан footerColor , приоритет имеет это поле.

DimensionGroup

Группа, расположенная на листе в интервале строк или столбцов, может содержать другие группы или быть включена в другие группы. Группа может быть свернута или развернута как единое целое на листе.

JSON-представление
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
Поля
range

object ( DimensionRange )

Ареал распространения этой группы.

depth

integer

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

collapsed

boolean

Это поле истинно, если данная группа свернута. Свернутая группа остается свернутой, если расширяется перекрывающаяся группа на меньшей глубине.

Значение true не означает, что все измерения в группе скрыты, поскольку видимость измерения может изменяться независимо от этого свойства группы. Однако при обновлении этого свойства все измерения в группе становятся скрытыми, если это поле имеет значение true, или видимыми, если это поле имеет значение false.

Слайсер

Слайсер в листе.

JSON-представление
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
Поля
slicerId

integer

Идентификатор среза.

spec

object ( SlicerSpec )

Технические характеристики слайсера.

position

object ( EmbeddedObjectPosition )

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

SlicerSpec

Технические характеристики слайсера.

JSON-представление
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
Поля
dataRange

object ( GridRange )

Диапазон данных среза.

filterCriteria

object ( FilterCriteria )

Критерии фильтрации среза.

columnIndex

integer

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

applyToPivotTables

boolean

Значение True, если фильтр должен применяться к сводным таблицам. Если значение не задано, по умолчанию используется True .

title

string

Название слайсера.

textFormat

object ( TextFormat )

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

backgroundColor
(deprecated)

object ( Color )

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

backgroundColorStyle

object ( ColorStyle )

Цвет фона среза. Если backgroundColor также задан, приоритет имеет это поле.

horizontalAlignment

enum ( HorizontalAlign )

Горизонтальное выравнивание заголовка в срезе. Если не указано, по умолчанию используется выравнивание по LEFT

Стол

Стол.

JSON-представление
{
  "tableId": string,
  "name": string,
  "range": {
    object (GridRange)
  },
  "rowsProperties": {
    object (TableRowsProperties)
  },
  "columnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Поля
tableId

string

Идентификатор таблицы.

name

string

Название таблицы. Оно уникально для всех таблиц в одной и той же электронной таблице.

range

object ( GridRange )

Диапазон цен на столы.

rowsProperties

object ( TableRowsProperties )

Свойства строк таблицы.

columnProperties[]

object ( TableColumnProperties )

Свойства столбцов таблицы.

TableRowsProperties

Свойства строк таблицы.

JSON-представление
{
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Поля
headerColorStyle

object ( ColorStyle )

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

firstBandColorStyle

object ( ColorStyle )

Первый чередующийся цвет. Если это поле задано, первая полосатая строка заполняется указанным цветом. В противном случае первая полосатая строка заполняется цветом по умолчанию.

secondBandColorStyle

object ( ColorStyle )

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

footerColorStyle

object ( ColorStyle )

Цвет последней строки. Если это поле не задано, нижний колонтитул не добавляется, последняя строка заполняется либо цветом firstBandColorStyle , либо secondBandColorStyle в зависимости от цвета предыдущей строки. При обновлении существующей таблицы без нижнего колонтитула для добавления нижнего колонтитула диапазон будет расширен на 1 строку. При обновлении существующей таблицы с нижним колонтитулом и удалении нижнего колонтитула диапазон будет сужен на 1 строку.

TableColumnProperties

Столбец таблицы.

JSON-представление
{
  "columnIndex": integer,
  "columnName": string,
  "columnType": enum (ColumnType),
  "dataValidationRule": {
    object (TableColumnDataValidationRule)
  }
}
Поля
columnIndex

integer

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

columnName

string

Название столбца.

columnType

enum ( ColumnType )

Тип столбца.

dataValidationRule

object ( TableColumnDataValidationRule )

Правило проверки данных столбца. Устанавливается только для столбцов типа «Выпадающий список».

Тип столбца

Тип столбца для заданного столбца в таблице.

Перечисления
COLUMN_TYPE_UNSPECIFIED Тип столбца не указан.
DOUBLE Тип столбца с числом.
CURRENCY Тип столбца валюты.
PERCENT Тип столбца: проценты.
DATE Тип столбца «Дата».
TIME Тип столбца времени.
DATE_TIME Тип столбца даты и времени.
TEXT Тип текстового столбца.
BOOLEAN Логический тип столбца.
DROPDOWN Тип столбца выпадающего списка.
FILES_CHIP Тип столбца чипа файлов
PEOPLE_CHIP Тип колонки с чипами для людей
FINANCE_CHIP Тип колонки финансовых чипов
PLACE_CHIP Тип колонки с чипами для размещения
RATINGS_CHIP Тип колонки с рейтинговыми чипами

Правило проверки данных таблицы TableColumnData

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

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

object ( BooleanCondition )

Условие, которому должны соответствовать данные в ячейке. Действительно только если [BooleanCondition.type] равно ONE_OF_LIST.