Este guia descreve como e por que usar a API Google Sheets para criar tabelas dinâmicas em suas planilhas.
O que é uma tabela dinâmica?
As tabelas dinâmicas oferecem uma maneira de resumir dados em sua planilha, agregando, classificando, contando ou calculando automaticamente os dados e exibindo os resultados resumidos em uma nova tabela. Uma tabela dinâmica funciona como uma espécie de consulta em um conjunto de dados de origem. Esses dados de origem existem em outro local na planilha, e a tabela dinâmica apresenta uma visualização processada dos dados.
Por exemplo, considere o seguinte conjunto de dados de vendas:
A | B | C | D | E | F | G | |
1 | Categoria do item | Número do modelo | Custo | Quantidade | Região | Vendedor | Data de envio |
2 | Roda gigante | W-24 | US$ 20,50 | 4 | Oeste | Beth | 01/03/2016 |
3 | Porta | Dado | US$ 15,00 | 2 | Sul | Amir | 15/03/2016 |
4 | Mecanismo | ENG-0134 | R$ 100,00 | 1 | Norte | Carmen | 20/03/2016 |
5 | Quadro | FR-0B1 | US$ 34,00 | 8 | Leste | Hannah | 12/03/2016 |
6 | Painel | P-034 | US$ 6,00 | 4 | Norte | Devyn | 02/04/2016 |
7 | Painel | P-052 | US$ 11,50 | 7 | Leste | Erik | 16/05/2016 |
8 | Roda gigante | W-24 | US$ 20,50 | 11 | Sul | Sheldon | 30/04/2016 |
9 | Mecanismo | ENG-0161 | US$ 330,00 | 2 | Norte | Jéssica | 02/07/2016 |
10 | Porta | D-01Y | US$ 29,00 | 6 | Oeste | Armando | 13/03/2016 |
11 | Quadro | FR-0B1 | US$ 34,00 | 9 | Sul | Yuliana | 27/02/2016 |
12 | Painel | P-102 | US$ 3,00 | 15 | Oeste | Carmen | 18/04/2016 |
13 | Painel | P-105 | US$ 8,25 | 13 | Oeste | Jéssica | 20/06/2016 |
14 | Mecanismo | ENG-0211 | US$ 283,00 | 1 | Norte | Amir | 21/06/2016 |
15 | Porta | Dado | US$ 15,00 | 2 | Oeste | Armando | 03/07/2016 |
16 | Quadro | FR-0B1 | US$ 34,00 | 6 | Sul | Carmen | 15/07/2016 |
17 | Roda gigante | W-25 | US$ 20,00 | 8 | Sul | Hannah | 02/05/2016 |
18 | Roda gigante | W-11 | US$ 29,00 | 13 | Leste | Erik | 19/05/2016 |
19 | Porta | D-05 | US$ 17,70 | 7 | Oeste | Beth | 28/06/2016 |
20 | Quadro | FR-0B1 | US$ 34,00 | 8 | Norte | Sheldon | 30/03/2016 |
É possível usar uma tabela dinâmica para criar um relatório que mostra quantos números de cada modelo foram vendidos em cada região:
Para obter o código-fonte usado para gerar a tabela dinâmica, consulte a seção Exemplo abaixo.
Depois que uma tabela dinâmica é inserida em uma planilha, os usuários podem alterar de forma interativa a estrutura e os detalhes do resumo usando a IU do Planilhas.
Como trabalhar com tabelas dinâmicas
A definição de uma tabela dinâmica está associada a uma única célula da página. Embora a aparência renderizada tenha muitas células em altura e largura, ela está localizada programaticamente na coordenada de uma única célula. Essa célula se torna o canto superior esquerdo da tabela dinâmica renderizada, com a extensão horizontal e vertical determinada por sua definição.
Como adicionar uma tabela dinâmica
Para adicionar uma tabela dinâmica, use o método batchUpdate, fornecendo uma solicitação updateCells. Use essa solicitação para fornecer uma definição de PivotTable como o conteúdo de uma célula, conforme mostrado abaixo:
"updateCells": {
"rows": {
"values": [{
"pivotTable": MyPivotTable
},
"start": {
"sheetId": sheetId,
"rowIndex": 0,
"columnIndex": 0
},
"fields": "pivotTable"
}
Isso coloca a tabela dinâmica descrita por MyPivotTable
na página especificada, com o canto superior esquerdo na célula A1
. A altura e a largura da tabela dinâmica são dinâmicas, você especifica apenas a origem.
O tipo PivotTable permite especificar:
- Intervalo de dados de origem
- Um ou mais campos cujos dados formarão as linhas da tabela dinâmica
- Um ou mais campos cujos dados formarão as colunas da tabela dinâmica
- Critérios de filtragem e agregação
- Layout da tabela dinâmica
Como modificar e excluir tabelas dinâmicas
Não há solicitações explícitas para modificar ou excluir uma tabela dinâmica. Em vez disso, use uma solicitação updateCells com conteúdos de célula diferentes:
- Para modificar uma tabela dinâmica, crie uma definição de PivotTable modificada e atualize a célula usando-a, de maneira semelhante a adicionar uma nova tabela dinâmica.
- Para excluir uma tabela dinâmica, atualize a célula com valores vazios. Por exemplo, consulte a amostra Excluir uma tabela dinâmica.
Casos de uso
Existem muitos usos diferentes para tabelas dinâmicas em uma ampla variedade de áreas, incluindo análise estatística, aplicativos de ERP, relatórios financeiros e outras. Os casos de uso das tabelas dinâmicas clássicas incluem itens como:
- Total de vendas por região e trimestre
- Salário médio por cargo e local
- Contagem de incidentes por produto e hora do dia
O número de possíveis aplicações das tabelas dinâmicas é grande, e a capacidade de gerá-las de maneira programática é muito útil. É possível gerar tabelas dinâmicas compatíveis com a exploração interativa, mas que são adaptadas a circunstâncias específicas, por exemplo:
- Explorar dados de incidentes do período de 24 horas mais recente
- Conferir/analisar dados agregados correspondentes à conta selecionada
- Examinar dados de vendas para territórios pertencentes ao usuário atual
Exemplo
Neste exemplo, criamos uma tabela dinâmica com base em um conjunto de dados para produzir o relatório "número do modelo por região", mostrado na introdução desta página. Para mais exemplos, consulte a página de exemplo de tabela dinâmica.