В этом руководстве описано, как и зачем использовать API Google Sheets для создания сводных таблиц в ваших электронных таблицах.
Что такое сводная таблица?
Сводные таблицы позволяют обобщить данные в электронной таблице, автоматически агрегируя, сортируя, подсчитывая или усредняя данные и отображая обобщенные результаты в новой таблице. Сводная таблица действует как своего рода запрос к исходному набору данных. Эти исходные данные находятся в другом месте электронной таблицы, а сводная таблица представляет собой обработанное представление данных.
Например, рассмотрим следующий набор данных о продажах:
| А | Б | С | Д | Е | Ф | Г | |
| 1 | Категория товара | Номер модели | Расходы | Количество | Область | Продавец | Дата отгрузки |
| 2 | Колесо | В-24 | 20,50 долларов | 4 | Запад | Бет | 01.03.2016 |
| 3 | Дверь | Д-01X | 15,00 долларов | 2 | Юг | Амир | 15.03.2016 |
| 4 | Двигатель | ENG-0134 | 100,00 долларов США | 1 | Север | Кармен | 20.03.2016 |
| 5 | Рамка | FR-0B1 | 34,00 долларов | 8 | Восток | Ханна | 3/12/2016 |
| 6 | Панель | П-034 | 6,00 долларов | 4 | Север | Девин | 02.04.2016 |
| 7 | Панель | П-052 | 11,50 долларов | 7 | Восток | Эрик | 16.05.2016 |
| 8 | Колесо | В-24 | 20,50 долларов | 11 | Юг | Шелдон | 30.04.2016 |
| 9 | Двигатель | ENG-0161 | 330,00 долларов США | 2 | Север | Джесси | 07.02.2016 |
| 10 | Дверь | Д-01Y | 29,00 долларов | 6 | Запад | Армандо | 13.03.2016 |
| 11 | Рамка | FR-0B1 | 34,00 долларов | 9 | Юг | Юлиана | 27.02.2016 |
| 12 | Панель | П-102 | 3,00 доллара | 15 | Запад | Кармен | 18.04.2016 |
| 13 | Панель | П-105 | 8,25 долларов | 13 | Запад | Джесси | 20.06.2016 |
| 14 | Двигатель | ENG-0211 | 283,00 долларов США | 1 | Север | Амир | 21.06.2016 |
| 15 | Дверь | Д-01X | 15,00 долларов | 2 | Запад | Армандо | 07.03.2016 |
| 16 | Рамка | FR-0B1 | 34,00 долларов | 6 | Юг | Кармен | 15.07.2016 |
| 17 | Колесо | В-25 | 20,00 долларов | 8 | Юг | Ханна | 05.02.2016 |
| 18 | Колесо | В-11 | 29,00 долларов | 13 | Восток | Эрик | 19.05.2016 |
| 19 | Дверь | Д-05 | 17,70 долларов | 7 | Запад | Бет | 28.06.2016 |
| 20 | Рамка | FR-0B1 | 34,00 долларов | 8 | Север | Шелдон | 30.03.2016 |
Для создания отчета, показывающего количество проданных экземпляров каждой модели в каждом регионе, можно использовать сводную таблицу:

Исходный код, использованный для создания этой сводной таблицы, см. в разделе «Пример» ниже.
После размещения сводной таблицы в электронной таблице пользователи могут интерактивно изменять структуру и детали сводки с помощью пользовательского интерфейса Google Sheets.
Работа со сводными таблицами
Определение сводной таблицы связано с одной ячейкой на листе. Хотя на экране она отображается в виде множества ячеек как по высоте, так и по ширине, программно она располагается в одной ячейке. Эта ячейка становится верхним левым углом отображаемой сводной таблицы, а её горизонтальные и вертикальные размеры определяются её определением.
Добавление сводной таблицы
Для добавления сводной таблицы используйте метод batchUpdate , отправив запрос updateCells . Этот запрос используется для передачи определения сводной таблицы в качестве содержимого ячейки, как показано ниже:
{
"updateCells": {
"rows": {
"values": [
{
"pivotTable": "MyPivotTable"
}
],
"start": {
"sheetId": "sheetId",
"rowIndex": 0,
"columnIndex": 0
},
"fields": "pivotTable"
}
}
}
Это разместит сводную таблицу, описываемую параметром MyPivotTable , на указанном листе, расположив верхний левый угол в ячейке A1 . (Высота и ширина сводной таблицы динамические; вы указываете только начало координат.)
Тип PivotTable позволяет указать:
- Диапазон исходных данных
- Одно или несколько полей, данные которых будут формировать строки сводной таблицы.
- Одно или несколько полей, данные которых будут формировать столбцы сводной таблицы.
- Критерии фильтрации и агрегирования
- Макет сводной таблицы
Изменение и удаление сводных таблиц
Явных запросов на изменение или удаление сводной таблицы не требуется. Вместо этого используйте запрос updateCells с другим содержимым ячеек:
- Чтобы изменить сводную таблицу, создайте измененное определение сводной таблицы и обновите ячейку, использующую его, аналогично добавлению новой сводной таблицы.
- Чтобы удалить сводную таблицу, обновите ячейку, указав пустые значения. Пример см. в разделе «Удаление сводной таблицы» .
Варианты использования
Сводные таблицы находят широкое применение в самых разных областях, включая статистический анализ, ERP-системы, финансовую отчетность и многое другое. Классические примеры использования сводных таблиц включают в себя:
- Общий объем продаж по регионам и кварталам
- Средняя заработная плата в зависимости от должности и местоположения.
- Количество инцидентов по видам продукции и времени суток.
Сводные таблицы обладают огромным потенциалом применения, а возможность их программного создания — мощным инструментом. Вы можете создавать сводные таблицы, поддерживающие интерактивный анализ, но адаптированные к конкретным условиям, например:
- Проанализируйте данные об инцидентах за последние 24 часа.
- Просмотр или анализ сводных данных, относящихся к выбранному аккаунту.
- Проанализируйте данные о продажах по территориям, принадлежащим текущему пользователю.
Пример
В этом примере создается сводная таблица на основе набора данных для формирования отчета «Номер модели по регионам», показанного во введении к этой странице. Дополнительные примеры см. на странице с примерами сводных таблиц .