Pivot Tables

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

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

Представление JSON

{ "rows": [ { object (PivotGroup) } ], "columns": [ { object (PivotGroup) } ], "criteria": { integer: { object (PivotFilterCriteria) }, ... }, "filterSpecs": [ { object (PivotFilterSpec) } ], "values": [ { object (PivotValue) } ], "valueLayout": enum (PivotValueLayout), "dataExecutionStatus": { object (DataExecutionStatus) }, // Union field source_data can be only one of the following: "source": { object (GridRange) }, "dataSourceId": string // End of list of possible types for union field source_data. }

Поля
rows[]	object ( PivotGroup ) Каждая группа строк в сводной таблице.
columns[]	object ( PivotGroup ) Каждая группа столбцов в сводной таблице.
criteria (deprecated)	map (key: integer, value: object ( PivotFilterCriteria )) Этот предмет устарел! Необязательное сопоставление фильтров для смещения исходного столбца. Фильтры применяются перед агрегированием данных в сводную таблицу. Ключ карты — это смещение столбца исходного диапазона, который вы хотите отфильтровать, а значение — это критерий для этого столбца. Например, если источником был C10:E15 , ключ 0 будет иметь фильтр для столбца C , а ключ 1 — для столбца D Это поле устарело в пользу filterSpecs .
filterSpecs[]	object ( PivotFilterSpec ) Фильтры применялись к исходным столбцам перед агрегированием данных для сводной таблицы. И criteria , и filterSpecs заполняются в ответах. Если в запросе на обновление указаны оба поля, это поле имеет приоритет.
values[]	object ( PivotValue ) Список значений для включения в сводную таблицу.
valueLayout	enum ( PivotValueLayout ) Должны ли значения быть перечислены по горизонтали (в виде столбцов) или по вертикали (в виде строк).
dataExecutionStatus	object ( DataExecutionStatus ) Только вывод. Статус выполнения данных для сводных таблиц источников данных.
Поле объединения source_data . Источник данных сводной таблицы. source_data может быть только одним из следующих:
source	object ( GridRange ) Диапазон, из которого сводная таблица считывает данные.
dataSourceId	string Идентификатор источника данных, из которого сводная таблица считывает данные.

Сводная группа

Одна группа (строка или столбец) в сводной таблице.

Представление JSON

{ "showTotals": boolean, "valueMetadata": [ { object (PivotGroupValueMetadata) } ], "sortOrder": enum (SortOrder), "valueBucket": { object (PivotGroupSortValueBucket) }, "repeatHeadings": boolean, "label": string, "groupRule": { object (PivotGroupRule) }, "groupLimit": { object (PivotGroupLimit) }, // Union field source can be only one of the following: "sourceColumnOffset": integer, "dataSourceColumnReference": { object (DataSourceColumnReference) } // End of list of possible types for union field source. }

Поля
showTotals	boolean Истинно, если сводная таблица должна включать итоги для этой группировки.
valueMetadata[]	object ( PivotGroupValueMetadata ) Метаданные о значениях в группе.
sortOrder	enum ( SortOrder ) Порядок сортировки значений в этой группе.
valueBucket	object ( PivotGroupSortValueBucket ) Сегмент противоположной сводной группы для сортировки. Если не указано, сортировка выполняется в алфавитном порядке по значениям этой группы.
repeatHeadings	boolean True, если заголовки в этой сводной группе должны повторяться. Это допустимо только для групп строк и игнорируется столбцами. По умолчанию мы минимизируем повторение заголовков, не показывая заголовки более высокого уровня, где они совпадают. Например, несмотря на то, что третья строка ниже соответствует «Q1 Mar», «Q1» не отображается, потому что она дублирует предыдущие строки. Если для параметра RepeatHeadings задано значение true, "Q1" будет повторяться для "февраля" и "марта". +--------------+ | Q1 | Jan | | | Feb | | | Mar | +--------+-----+ | Q1 Total | +--------------+
label	string Метки, используемые для групп строк/столбцов, которые можно настроить. Например, в следующей сводной таблице метка строки — Region » (которую можно переименовать в State »), а метка столбца — « Product » (которую можно переименовать в Item ). Сводные таблицы, созданные до декабря 2017 г., не имеют меток заголовков. Если вы хотите добавить метки заголовков к существующей сводной таблице, удалите существующую сводную таблицу, а затем создайте новую сводную таблицу с теми же параметрами. +--------------+---------+-------+ | SUM of Units | Product | | | Region | Pen | Paper | +--------------+---------+-------+ | New York | 345 | 98 | | Oregon | 234 | 123 | | Tennessee | 531 | 415 | +--------------+---------+-------+ | Grand Total | 1110 | 636 | +--------------+---------+-------+
groupRule	object ( PivotGroupRule ) Групповое правило, применяемое к этой группе строк/столбцов.
groupLimit	object ( PivotGroupLimit ) Ограничение количества строк или столбцов, применяемое к этой сводной группе.
source поля союза. Источник данных сводной группы. source может быть только одним из следующих:
sourceColumnOffset	integer Смещение столбца исходного диапазона, на котором основана эта группировка. Например, если источником был C10:E15 , sourceColumnOffset равный 0 , означает, что эта группа относится к столбцу C , тогда как смещение 1 будет относиться к столбцу D .
dataSourceColumnReference	object ( DataSourceColumnReference ) Ссылка на столбец источника данных, на котором основана эта группировка.

PivotGroupValueMetadata

Метаданные о значении в сводной группе.

Представление JSON
{ "value": { object (ExtendedValue) }, "collapsed": boolean }

Поля
value	object ( ExtendedValue ) Расчетное значение, которому соответствуют метаданные. (Обратите внимание, что formulaValue недействителен, поскольку значения будут вычисляться.)
collapsed	boolean Истинно, если данные, соответствующие значению, свернуты.

PivotGroupSortValueBucket

Информация о том, какие значения в сводной группе следует использовать для сортировки.

Представление JSON
{ "valuesIndex": integer, "buckets": [ { object (ExtendedValue) } ] }

Поля
valuesIndex	integer Смещение в списке PivotTable.values , по которому следует сортировать значения в этой группе.
buckets[]	object ( ExtendedValue ) Определяет сегмент, из которого выбираются значения для сортировки. Например, в сводной таблице с одной группой строк и двумя группами столбцов группа строк может содержать до двух значений. Первое значение соответствует значению в первой группе столбцов, а второе значение соответствует значению во второй группе столбцов. Если значения не указаны, это будет означать, что строка должна быть отсортирована в соответствии с «Общим итогом» по группам столбцов. Если указано одно значение, это будет соответствовать использованию «Всего» этого сегмента.

PivotGroupRule

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

Представление JSON
{ // Union field rule can be only one of the following: "manualRule": { object (ManualRule) }, "histogramRule": { object (HistogramRule) }, "dateTimeRule": { object (DateTimeRule) } // End of list of possible types for union field rule. }

Поля
rule союзного поля. Правило, применяемое к PivotGroup . rule может быть только одним из следующих:
manualRule	object ( ManualRule ) ManualRule .
histogramRule	object ( HistogramRule ) HistogramRule .
dateTimeRule	object ( DateTimeRule ) DateTimeRule .

ManualRule

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

+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK    |               0.7 |
| AL    |               4.8 |
| AR    |               2.9 |
...
+-------+-------------------+

можно превратить в сводную таблицу, которая объединяет население по часовым поясам, предоставляя список групп (например, groupName = 'Central', items = ['AL', 'AR', 'IA', ...]) для ручное групповое правило. Обратите внимание, что аналогичного эффекта можно добиться, добавив столбец часового пояса к исходным данным и настроив сводную таблицу.

+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central   |             106.3 |
| Eastern   |             151.9 |
| Mountain  |              17.4 |
...
+-----------+-------------------+

Представление JSON
{ "groups": [ { object (ManualRuleGroup) } ] }

Поля
groups[]	object ( ManualRuleGroup ) Список имен групп и соответствующие элементы из исходных данных, которые сопоставляются с каждым именем группы.

ManualRuleGroup

Название группы и список элементов исходных данных, которые следует поместить в группу с этим названием.

Представление JSON
{ "groupName": { object (ExtendedValue) }, "items": [ { object (ExtendedValue) } ] }

Поля
groupName	object ( ExtendedValue ) Имя группы, которое должно быть строкой. Каждая группа в данном ManualRule должна иметь уникальное имя группы.
items[]	object ( ExtendedValue ) Элементы исходных данных, которые следует поместить в эту группу. Каждый элемент может быть строкой, числом или логическим значением. Элементы могут появляться не более чем в одной группе в данном ManualRule . Элементы, которые не отображаются ни в одной группе, появятся сами по себе.

Правило гистограммы

Позволяет организовать числовые значения в столбце исходных данных в сегменты постоянного размера. Все значения от HistogramRule.start до HistogramRule.end помещаются в группы размера HistogramRule.interval . Кроме того, все значения ниже HistogramRule.start помещаются в одну группу, а все значения выше HistogramRule.end помещаются в другую. Требуется только HistogramRule.interval , хотя, если HistogramRule.start и HistogramRule.end оба предоставлены, HistogramRule.start должен быть меньше, чем HistogramRule.end . Например, сводная таблица, показывающая среднюю сумму покупки по возрасту и состоящая из 50+ строк:

+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16  |            $27.13 |
| 17  |             $5.24 |
| 18  |            $20.15 |
...
+-----+-------------------+

можно превратить в сводную таблицу, которая выглядит так, как показано ниже, применив групповое правило гистограммы с HistogramRule.start , равным 25, HistogramRule.interval , равным 20, и HistogramRule.end , равным 65.

+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25        |            $19.34 |
| 25-45       |            $31.43 |
| 45-65       |            $35.87 |
| > 65        |            $27.55 |
+-------------+-------------------+
| Grand Total |            $29.12 |
+-------------+-------------------+

Представление JSON
{ "interval": number, "start": number, "end": number }

Поля
interval	number Размер создаваемых сегментов. Должен быть положительным.
start	number Минимальное значение, при котором элементы помещаются в сегменты постоянного размера. Значения ниже start объединяются в одно ведро. Это поле является необязательным.
end	number Максимальное значение, при котором элементы помещаются в сегменты постоянного размера. Значения выше конца объединяются в одно ведро. Это поле является необязательным.

ДатаВремяПравило

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

+----------+--------------+
| Date     | SUM of Sales |
+----------+--------------+
| 1/1/2017 |      $621.14 |
| 2/3/2017 |      $708.84 |
| 5/8/2017 |      $326.84 |
...
+----------+--------------+

Применение группового правила даты и времени с DateTimeRuleType , равным YEAR_MONTH, приводит к следующей сводной таблице.

+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan     |   $53,731.78 |
| 2017-Feb     |   $83,475.32 |
| 2017-Mar     |   $94,385.05 |
...
+--------------+--------------+

Представление JSON
{ "type": enum (DateTimeRuleType) }

Поля
type	enum ( DateTimeRuleType ) Применяемый тип группировки даты и времени.

DateTimeRuleType

Доступные типы правил группировки даты и времени. В этой документации предполагается, что языковой стандарт электронной таблицы — «en-US», хотя фактическое отображение дат и времени использует языковой стандарт электронной таблицы для некоторых типов правил.

перечисления
DATE_TIME_RULE_TYPE_UNSPECIFIED	Тип по умолчанию, не использовать.
SECOND	Группировать даты по секундам, от 0 до 59.
MINUTE	Сгруппируйте даты по минутам, от 0 до 59.
HOUR	Сгруппируйте даты по часам, используя 24-часовую систему, от 0 до 23.
HOUR_MINUTE	Сгруппируйте даты по часам и минутам, используя 24-часовую систему, например 19:45.
HOUR_MINUTE_AMPM	Сгруппируйте даты по часам и минутам, используя 12-часовую систему, например 19:45. Обозначение AM/PM переводится в зависимости от языкового стандарта электронной таблицы.
DAY_OF_WEEK	Сгруппируйте даты по дням недели, например воскресенье. Дни недели будут переведены в зависимости от языкового стандарта электронной таблицы.
DAY_OF_YEAR	Сгруппируйте даты по дням года, от 1 до 366. Обратите внимание, что даты после 29 февраля попадают в разные корзины в високосные годы и в невисокосные годы.
DAY_OF_MONTH	Сгруппируйте даты по дням месяца, от 1 до 31.
DAY_MONTH	Сгруппируйте даты по дням и месяцам, например, 22 ноября. Месяц переводится на основе языкового стандарта электронной таблицы.
MONTH	Сгруппируйте даты по месяцам, например, ноябрь. Месяц переводится в зависимости от языкового стандарта электронной таблицы.
QUARTER	Сгруппируйте даты по кварталам, например Q1 (что соответствует январю-марту).
YEAR	Сгруппируйте даты по годам, например 2008.
YEAR_MONTH	Сгруппируйте даты по годам и месяцам, например 2008-ноябрь. Месяц переводится на основе языкового стандарта электронной таблицы.
YEAR_QUARTER	Сгруппируйте даты по годам и кварталам, например 2008 Q4.
YEAR_MONTH_DAY	Сгруппируйте даты по году, месяцу и дню, например 2008-11-22.

PivotGroupLimit

Ограничение количества строк или столбцов в сводной группе.

Представление JSON
{ "countLimit": integer, "applyOrder": integer }

Поля
countLimit	integer Лимит счета.
applyOrder	integer Порядок, в котором ограничение группы применяется к сводной таблице. Ограничения сводной группы применяются от меньшего к большему порядковому номеру. Номера заказов нормированы на последовательные целые числа от 0. Для запроса на запись, чтобы полностью настроить прикладные заказы, во всех ограничениях сводной группы это поле должно быть установлено с уникальным номером. В противном случае порядок определяется индексом в списке PivotTable.rows , а затем в списке PivotTable.columns .

PivotFilterCriteria

Критерии отображения/скрытия строк в сводной таблице.

Представление JSON
{ "visibleValues": [ string ], "condition": { object (BooleanCondition) }, "visibleByDefault": boolean }

Поля
visibleValues[]	string Значения, которые должны быть включены. Значения, не указанные здесь, исключаются.
condition	object ( BooleanCondition ) Условие, которое должно быть истинным для отображения значений. ( visibleValues ​​не переопределяет это - даже если значение указано там, оно все равно скрыто, если не соответствует условию.) Значения условий, которые относятся к диапазонам в нотации A1, оцениваются относительно листа сводной таблицы. Ссылки обрабатываются абсолютно, поэтому не заполняются сводной таблицей. Например, значение условия =A1 в «Сводной таблице 1» обрабатывается как 'Pivot Table 1'!$A$1 . На исходные данные сводной таблицы можно ссылаться по имени заголовка столбца. Например, если в исходных данных есть столбцы с именами «Доход» и «Стоимость», а к столбцу «Доход» применяется условие с типом NUMBER_GREATER и значением =Cost , то включаются только столбцы, в которых «Доход» > «Стоимость».
visibleByDefault	boolean Отображаются ли значения по умолчанию. Если true, visibleValues ​​игнорируются, отображаются все значения, соответствующие condition (если оно указано). Если false, отображаются значения, которые находятся как в visibleValues , так и соответствуют condition .

PivotFilterSpec

Критерии фильтра сводной таблицы, связанные с определенным смещением исходного столбца.

Представление JSON
{ "filterCriteria": { object (PivotFilterCriteria) }, // Union field source can be only one of the following: "columnOffsetIndex": integer, "dataSourceColumnReference": { object (DataSourceColumnReference) } // End of list of possible types for union field source. }

Поля
filterCriteria	object ( PivotFilterCriteria ) Критерии столбца.
source поля союза. Исходный столбец, к которому применяется этот фильтр. source может быть только одним из следующих:
columnOffsetIndex	integer Отсчитываемое от нуля смещение столбца исходного диапазона.
dataSourceColumnReference	object ( DataSourceColumnReference ) Ссылка на столбец источника данных.

PivotValue

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

Представление JSON
{ "summarizeFunction": enum (PivotValueSummarizeFunction), "name": string, "calculatedDisplayType": enum (PivotValueCalculatedDisplayType), // Union field value can be only one of the following: "sourceColumnOffset": integer, "formula": string, "dataSourceColumnReference": { object (DataSourceColumnReference) } // End of list of possible types for union field value. }

Поля
summarizeFunction	enum ( PivotValueSummarizeFunction ) Функция для суммирования значения. Если задана formula , поддерживаются только значения SUM и CUSTOM . Если установлено sourceColumnOffset , CUSTOM не поддерживается.
name	string Имя, используемое для значения.
calculatedDisplayType	enum ( PivotValueCalculatedDisplayType ) Если указано, указывает, что опорные значения должны отображаться как результат вычисления с другим опорным значением. Например, если для calculateDisplayType указано значение PERCENT_OF_GRAND_TOTAL, все сводные значения отображаются в процентах от общей суммы. В редакторе таблиц это называется «Показать как» в разделе значений сводной таблицы.
value поля объединения. Данные, используемые для значений в сводной таблице. Должно быть установлено ровно одно значение. value может быть только одним из следующих:
sourceColumnOffset	integer Смещение столбца исходного диапазона, из которого считывается это значение. Например, если источником был C10:E15 , sourceColumnOffset равный 0 означает, что это значение относится к столбцу C , тогда как смещение 1 будет относиться к столбцу D .
formula	string Пользовательская формула для расчета стоимости. Формула должна начинаться с символа = .
dataSourceColumnReference	object ( DataSourceColumnReference ) Ссылка на столбец источника данных, из которого считывается это значение.

PivotValueSummarizeFunction

Функция для суммирования опорного значения.

перечисления
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED	По умолчанию не использовать.
SUM	Соответствует функции SUM .
COUNTA	Соответствует функции COUNTA .
COUNT	Соответствует функции COUNT .
COUNTUNIQUE	Соответствует функции COUNTUNIQUE .
AVERAGE	Соответствует функции AVERAGE .
MAX	Соответствует функции MAX .
MIN	Соответствует функции MIN .
MEDIAN	Соответствует функции MEDIAN .
PRODUCT	Соответствует функции PRODUCT .
STDEV	Соответствует функции STDEV .
STDEVP	Соответствует функции STDEVP .
VAR	Соответствует функции VAR .
VARP	Соответствует функции VARP .
CUSTOM	Указывает, что формулу следует использовать как есть. Действителен, только если установлен параметр PivotValue.formula .

PivotValueCalculatedDisplayType

Возможные способы вычисления опорных значений для отображения.

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

PivotValueLayout

Расположение сводных значений.

перечисления
HORIZONTAL	Значения располагаются горизонтально (в виде столбцов).
VERTICAL	Значения располагаются вертикально (в виде строк).