Class PivotTable

Сводная таблица

Доступ к сводным таблицам и их изменение.

Методы

Метод Тип возвращаемого значения Краткое описание
add Calculated Pivot Value(name, formula) Pivot Value Создает новое значение в сводной таблице, вычисленное по указанной formula с указанным name .
add Column Group(sourceDataColumn) Pivot Group Определяет новую группировку столбцов сводной таблицы.
add Filter(sourceDataColumn, filterCriteria) Pivot Filter Создает новый фильтр для сводной таблицы.
add Pivot Value(sourceDataColumn, summarizeFunction) Pivot Value Определяет новое значение сводной таблицы с указанной summarize Function .
add Row Group(sourceDataColumn) Pivot Group Определяет новую группировку строк сводной таблицы.
as Data Source Pivot Table() Data Source Pivot Table |null Возвращает сводную таблицу в качестве сводной таблицы источника данных, если сводная таблица связана с Data Source , или null в противном случае.
get Anchor Cell() Range Возвращает Range представляющий ячейку, к которой привязана эта сводная таблица.
get Column Groups() Pivot Group[] Возвращает упорядоченный список групп столбцов в этой сводной таблице.
get Filters() Pivot Filter[] Возвращает упорядоченный список фильтров из этой сводной таблицы.
get Pivot Values() Pivot Value[] Возвращает упорядоченный список значений сводной таблицы.
get Row Groups() Pivot Group[] Возвращает упорядоченный список групп строк в этой сводной таблице.
get Source Data Range() Range Возвращает диапазон исходных данных, на основе которого строится сводная таблица.
get Values Display Orientation() Dimension Возвращает значение, указывающее, отображаются ли значения в виде строк или столбцов.
remove() void Удаляет эту сводную таблицу.
set Values Display Orientation(dimension) Pivot Table Задает структуру сводной таблицы, отображая значения в виде столбцов или строк.

Подробная документация

addCalculatedPivotValue(name, formula)

Создает новое значение в сводной таблице, вычисленное по указанной formula с указанным name .

Параметры

Имя Тип Описание
name String Название этого вычисляемого опорного значения.
formula String Формула, использованная для расчета этого значения.

Возвращаться

PivotValue — недавно созданный PivotValue

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addColumnGroup(sourceDataColumn)

Определяет новую группировку столбцов сводной таблицы. Указанный sourceDataColumn обозначает столбец в исходных данных, на основе которого выполняется эта группировка.

Параметры

Имя Тип Описание
source Data Column Integer Номер столбца, который суммирует эта группа. Этот индекс представляет собой абсолютный номер столбца в электронной таблице; 1 обозначает столбец «A», 2 — столбец B и т. д.

Возвращаться

PivotGroup — недавно созданная PivotGroup

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addFilter(sourceDataColumn, filterCriteria)

Создает новый фильтр для сводной таблицы. Указанный sourceDataColumn обозначает столбец в исходных данных, с которым работает этот фильтр.

Параметры

Имя Тип Описание
source Data Column Integer Номер столбца, который суммирует эта группа. Этот индекс представляет собой абсолютный номер столбца в электронной таблице; 1 обозначает столбец «A», 2 — столбец B и т. д.
filter Criteria Filter Criteria Критерии фильтрации, использованные для выполнения фильтрации.

Возвращаться

PivotFilter — недавно созданный PivotFilter

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addPivotValue(sourceDataColumn, summarizeFunction)

Defines a new pivot value in the pivot table with the specified summarizeFunction . The specified sourceDataColumn indicates the column in the source data this value is based on.

Параметры

Имя Тип Описание
source Data Column Integer Номер столбца, который суммирует эта группа. Этот индекс представляет собой абсолютный номер столбца в электронной таблице; 1 обозначает столбец «A», 2 — столбец B и т. д.
summarize Function Pivot Table Summarize Function

Возвращаться

PivotValue — недавно созданный PivotValue

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addRowGroup(sourceDataColumn)

Определяет новую группировку строк сводной таблицы. Указанный sourceDataColumn обозначает столбец в исходных данных, на основе которого выполняется эта группировка.

Параметры

Имя Тип Описание
source Data Column Integer Номер столбца, который суммирует эта группа. Этот индекс представляет собой абсолютный номер столбца в электронной таблице; 1 обозначает столбец «A», 2 — столбец B и т. д.

Возвращаться

PivotGroup — недавно созданная PivotGroup

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

asDataSourcePivotTable()

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

Возвращаться

DataSourcePivotTable |null — Сводная таблица источника данных.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getAnchorCell()

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

Возвращаться

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

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getColumnGroups()

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

Возвращаться

PivotGroup[] — группы столбцов в этой сводной таблице

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getFilters()

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

Возвращаться

PivotFilter[] — фильтры в этой сводной таблице

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getPivotValues()

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

Возвращаться

PivotValue[] — сводные значения в этой сводной таблице

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRowGroups()

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

Возвращаться

PivotGroup[] — группы строк в этой сводной таблице

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSourceDataRange()

Возвращает диапазон исходных данных, на основе которого строится сводная таблица.

Возвращаться

Range — Диапазон исходных данных для этой сводной таблицы.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getValuesDisplayOrientation()

Возвращает значение, указывающее, отображаются ли значения в виде строк или столбцов.

Возвращаться

Dimension — отображает ли значение значения в виде строк или столбцов.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

remove()

Удаляет эту сводную таблицу. Дальнейшие операции с этой сводной таблицей приведут к ошибке.

Авторизация

Для скриптов, использующих этот метод, требуется авторизация в одной или нескольких из следующих областей действия :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setValuesDisplayOrientation(dimension)

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

Параметры

Имя Тип Описание
dimension Dimension Параметр, определяющий способ отображения сводных значений.

Возвращаться

PivotTable — сводная таблица для построения цепочек сообщений.

Авторизация

Scripts that use this method require authorization with one or more of the following scopes :

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets