В этом руководстве описывается, как и зачем использовать API Google Таблиц для создания сводных таблиц в электронных таблицах.
Что такое сводная таблица?
Сводные таблицы позволяют суммировать данные в электронной таблице, автоматически агрегируя, сортируя, подсчитывая или усредняя данные и отображая итоговые результаты в новой таблице. Сводная таблица действует как своего рода запрос к исходному набору данных. Эти исходные данные находятся в другом месте электронной таблицы, а сводная таблица представляет собой обработанное представление данных.
Например, рассмотрим следующий набор данных о продажах:
А | Б | С | Д | Э | Ф | Г | |
1 | Категория товара | Номер модели | Расходы | Количество | Область | Продавец | Дата отправки |
2 | Колесо | W-24 | 20,50 долларов | 4 | Запад | Бет | 01.03.2016 |
3 | Дверь | Д-01Х | 15,00 долларов США | 2 | Юг | Амир | 15.03.2016 |
4 | Двигатель | АНГ-0134 | 100,00 долларов США | 1 | Север | Кармен | 20.03.2016 |
5 | Рамка | ФР-0Б1 | 34,00 доллара США | 8 | Восток | Ханна | 3/12/2016 |
6 | Панель | П-034 | 6,00 долларов | 4 | Север | Девин | 02.04.2016 |
7 | Панель | П-052 | 11,50 долларов США | 7 | Восток | Эрик | 16.05.2016 |
8 | Колесо | W-24 | 20,50 долларов | 11 | Юг | Шелдон | 30.04.2016 |
9 | Двигатель | ЕНГ-0161 | 330,00 долларов США | 2 | Север | Джесси | 02.07.2016 |
10 | Дверь | Д-01Y | 29,00 долларов США | 6 | Запад | Армандо | 13.03.2016 |
11 | Рамка | ФР-0Б1 | 34,00 доллара США | 9 | Юг | Юлиана | 27.02.2016 |
12 | Панель | П-102 | 3,00 доллара | 15 | Запад | Кармен | 18.04.2016 |
13 | Панель | П-105 | 8,25 долларов | 13 | Запад | Джесси | 20.06.2016 |
14 | Двигатель | АНГ-0211 | 283,00 доллара США | 1 | Север | Амир | 21.06.2016 |
15 | Дверь | Д-01Х | 15,00 долларов США | 2 | Запад | Армандо | 03.07.2016 |
16 | Рамка | ФР-0Б1 | 34,00 доллара США | 6 | Юг | Кармен | 15.07.2016 |
17 | Колесо | W-25 | 20,00 долларов США | 8 | Юг | Ханна | 02.05.2016 |
18 | Колесо | W-11 | 29,00 долларов США | 13 | Восток | Эрик | 19.05.2016 |
19 | Дверь | Д-05 | 17,70 долларов США | 7 | Запад | Бет | 28.06.2016 |
20 | Рамка | ФР-0Б1 | 34,00 доллара США | 8 | Север | Шелдон | 30.03.2016 |
Вы можете использовать сводную таблицу для создания отчета, показывающего, сколько автомобилей каждой модели было продано в каждом регионе:
Исходный код, использованный для создания этой сводной таблицы, см. в разделе «Пример» ниже.
После размещения сводной таблицы в электронной таблице пользователи могут интерактивно изменять структуру и детали сводки, используя пользовательский интерфейс Таблиц.
Работа со сводными таблицами
Определение сводной таблицы связано с одной ячейкой на листе. Хотя при визуализации она выглядит как множество ячеек по высоте и ширине, программно она располагается в одной ячейке. Эта ячейка становится верхним левым углом визуализированной сводной таблицы, а её горизонтальные и вертикальные размеры определяются её определением.
Добавление сводной таблицы
Чтобы добавить сводную таблицу, используйте метод batchUpdate , передав запрос updateCells . Этот запрос используется для передачи определения сводной таблицы в качестве содержимого ячейки, как показано ниже:
{
"updateCells": {
"rows": {
"values": [
{
"pivotTable": "MyPivotTable"
}
],
"start": {
"sheetId": "sheetId",
"rowIndex": 0,
"columnIndex": 0
},
"fields": "pivotTable"
}
}
}
Это поместит сводную таблицу, описанную MyPivotTable
, на указанный лист, при этом верхний левый угол будет находиться в ячейке A1
. (Высота и ширина сводной таблицы являются динамическими; вы указываете только начало координат.)
Тип сводной таблицы позволяет указать:
- Диапазон исходных данных
- Одно или несколько полей, данные которых будут формировать строки сводной таблицы.
- Одно или несколько полей, данные которых будут формировать столбцы сводной таблицы.
- Критерии фильтрации и агрегации
- Макет сводной таблицы
Изменение и удаление сводных таблиц
Явных запросов на изменение или удаление сводной таблицы нет. Вместо этого используйте запрос updateCells с другим содержимым ячеек:
- Чтобы изменить сводную таблицу, создайте измененное определение сводной таблицы и обновите ячейку с его помощью, аналогично добавлению новой сводной таблицы.
- Чтобы удалить сводную таблицу, обновите ячейку пустыми значениями. Пример см. в разделе «Удаление сводной таблицы» .
Варианты использования
Сводные таблицы находят разнообразное применение в самых разных областях, включая статистический анализ, ERP-приложения, финансовую отчетность и другие. Классические примеры использования сводных таблиц включают в себя:
- Общий объем продаж по регионам и кварталам
- Средняя зарплата по должности и местоположению
- Количество инцидентов по продукту и времени суток
Число потенциальных применений сводных таблиц огромно, а возможность их программного создания весьма эффективна. Вы можете создавать сводные таблицы, поддерживающие интерактивное исследование, но адаптированные к конкретным условиям, например:
- Изучите данные об инцидентах за последние 24 часа
- Просмотр или анализ агрегированных данных, соответствующих выбранной учетной записи
- Изучите данные о продажах на территориях, принадлежащих текущему пользователю.
Пример
В этом примере создается сводная таблица на основе набора данных для формирования отчёта «Номер модели по региону», показанного во введении к этой странице. Дополнительные примеры см. на странице с примером сводной таблицы .