Pivot Tables

{
  "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.
}

object ( PivotGroup )

Группировка каждой строки в сводной таблице.

object ( PivotGroup )

Каждая группировка столбцов в сводной таблице.

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

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

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

Например, если источником был C10:E15 , ключ 0 будет иметь фильтр для столбца C , тогда как ключ 1 — для столбца D

Это поле устарело в пользу filterSpecs .

object ( PivotFilterSpec )

Фильтры применяются к исходным столбцам перед агрегированием данных для сводной таблицы.

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

object ( PivotValue )

Список значений для включения в сводную таблицу.

enum ( PivotValueLayout )

Должны ли значения располагаться горизонтально (в виде столбцов) или вертикально (в виде строк).

object ( DataExecutionStatus )

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

object ( GridRange )

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

string

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

{
  "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.
}

boolean

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

object ( PivotGroupValueMetadata )

Метаданные о значениях в группировке.

enum ( SortOrder )

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

object ( PivotGroupSortValueBucket )

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

boolean

True, если заголовки в этой сводной группе должны повторяться. Это справедливо только для групп строк и игнорируется столбцами.

По умолчанию мы сводим к минимуму повторение заголовков, не показывая заголовки более высокого уровня, где они совпадают. Например, несмотря на то, что третья строка ниже соответствует «1 кварталу марта», «1 квартал» не отображается, поскольку он дублирует предыдущие строки. Если для параметра restartHeadings установлено значение true, «Q1» будет повторяться для «Feb» и «Mar».

+--------------+
| Q1     | Jan |
|        | Feb |
|        | Mar |
+--------+-----+
| Q1 Total     |
+--------------+

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

object ( PivotGroupRule )

Групповое правило, применяемое к этой группе строк/столбцов.

object ( PivotGroupLimit )

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

integer

Смещение столбца исходного диапазона, на котором основана эта группировка.

Например, если источником был C10:E15 , sourceColumnOffset , равное 0 означает, что эта группа относится к столбцу C , тогда как смещение 1 будет относиться к столбцу D

object ( DataSourceColumnReference )

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

{
  "value": {
    object (ExtendedValue)
  },
  "collapsed": boolean
}

object ( ExtendedValue )

Расчетное значение, которому соответствуют метаданные. (Обратите внимание, что formulaValue недействителен, поскольку значения будут рассчитаны.)

boolean

True, если данные, соответствующие значению, свернуты.

{
  "valuesIndex": integer,
  "buckets": [
    {
      object (ExtendedValue)
    }
  ]
}

integer

Смещение в списке PivotTable.values , по которому следует сортировать значения в этой группе.

object ( ExtendedValue )

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

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

{

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

object ( ManualRule )

ManualRule .

object ( HistogramRule )

HistogramRule .

object ( DateTimeRule )

DateTimeRule .

{
  "groups": [
    {
      object (ManualRuleGroup)
    }
  ]
}

object ( ManualRuleGroup )

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

{
  "groupName": {
    object (ExtendedValue)
  },
  "items": [
    {
      object (ExtendedValue)
    }
  ]
}

object ( ExtendedValue )

Имя группы, которое должно быть строкой. Каждая группа в данном ManualRule должна иметь уникальное имя группы.

object ( ExtendedValue )

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

{
  "interval": number,
  "start": number,
  "end": number
}

number

Размер создаваемых сегментов. Должно быть позитивным.

number

Минимальное значение, при котором элементы помещаются в корзины постоянного размера. Значения ниже начального объединяются в один блок. Это поле является необязательным.

number

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

{
  "type": enum (DateTimeRuleType)
}

enum ( DateTimeRuleType )

Тип применяемой группировки даты и времени.

{
  "countLimit": integer,
  "applyOrder": integer
}

integer

Ограничение количества.

integer

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

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

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

{
  "visibleValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleByDefault": boolean
}

string

Ценности, которые следует включить. Значения, не перечисленные здесь, исключаются.

object ( BooleanCondition )

Условие, которое должно быть истинным для отображения значений. ( visibleValues ​​не отменяет это — даже если там указано значение, оно все равно скрыто, если не соответствует условию.)

Значения условий, которые относятся к диапазонам в нотации A1, оцениваются относительно листа сводной таблицы. Ссылки обрабатываются абсолютно, поэтому не заполняются сводной таблицей. Например, значение условия =A1 в «Сводной таблице 1» рассматривается как 'Pivot Table 1'!$A$1 .

На исходные данные сводной таблицы можно ссылаться по имени заголовка столбца. Например, если в исходных данных есть столбцы с именами «Доход» и «Затраты», а к столбцу «Доход» применено условие с типом NUMBER_GREATER и значением =Cost , то будут включены только столбцы, в которых «Доход» > «Затраты».

boolean

Видны ли значения по умолчанию. Если это правда, visibleValues игнорируются, отображаются все значения, соответствующие condition (если оно указано). Если значение false, отображаются значения, которые находятся в visibleValues и соответствуют condition .

{
  "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.
}

object ( PivotFilterCriteria )

Критерии для столбца.

integer

Смещение столбца исходного диапазона, отсчитываемое от нуля.

object ( DataSourceColumnReference )

Ссылка на столбец источника данных.

{
  "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.
}

enum ( PivotValueSummarizeFunction )

Функция для суммирования значения. Если задана formula , поддерживаются только значения SUM и CUSTOM . Если sourceColumnOffset установлен, CUSTOM не поддерживается.

string

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

enum ( PivotValueCalculatedDisplayType )

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

integer

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

Например, если источником был C10:E15 , sourceColumnOffset , равное 0 означает, что это значение относится к столбцу C , тогда как смещение 1 будет относиться к столбцу D

string

Пользовательская формула для расчета значения. Формула должна начинаться с символа = .

object ( DataSourceColumnReference )

Ссылка на столбец источника данных, из которого считывается это значение.