Esta página foi traduzida pela API Cloud Translation.

Class PivotTable

Acesse e modifique tabelas dinâmicas.

Métodos

Método	Tipo de retorno	Breve descrição
`addCalculatedPivotValue(name, formula)`	`PivotValue`	Cria um novo valor dinâmico na tabela dinâmica calculado com base no `formula` especificado com o `name` especificado.
`addColumnGroup(sourceDataColumn)`	`PivotGroup`	Define um novo agrupamento de colunas dinâmicas na tabela dinâmica.
`addFilter(sourceDataColumn, filterCriteria)`	`PivotFilter`	Cria um novo filtro para a tabela dinâmica.
`addPivotValue(sourceDataColumn, summarizeFunction)`	`PivotValue`	Define um novo valor dinâmico na tabela dinâmica com o valor `summarizeFunction` especificado.
`addRowGroup(sourceDataColumn)`	`PivotGroup`	Define um novo agrupamento de linhas dinâmicas na tabela dinâmica.
`asDataSourcePivotTable()`	`DataSourcePivotTable`	Retorna a tabela dinâmica como uma tabela dinâmica de fonte de dados se a tabela dinâmica estiver vinculada a um `DataSource`, ou `null` se não estiver.
`getAnchorCell()`	`Range`	Retorna a `Range` que representa a célula em que a tabela dinâmica está fixada.
`getColumnGroups()`	`PivotGroup[]`	Retorna uma lista ordenada dos grupos de colunas nesta tabela dinâmica.
`getFilters()`	`PivotFilter[]`	Retorna uma lista ordenada dos filtros nesta tabela dinâmica.
`getPivotValues()`	`PivotValue[]`	Retorna uma lista ordenada dos valores dinâmicos nesta tabela dinâmica.
`getRowGroups()`	`PivotGroup[]`	Retorna uma lista ordenada dos grupos de linhas nesta tabela dinâmica.
`getSourceDataRange()`	`Range`	Retorna o intervalo de dados de origem em que a tabela dinâmica é construída.
`getValuesDisplayOrientation()`	`Dimension`	Retorna se os valores são exibidos como linhas ou colunas.
`remove()`	`void`	Exclui esta tabela dinâmica.
`setValuesDisplayOrientation(dimension)`	`PivotTable`	Define o layout da tabela dinâmica para mostrar valores como colunas ou linhas.

Documentação detalhada

`addCalculatedPivotValue(name, formula)`

Cria um novo valor dinâmico na tabela dinâmica calculado com base no formula especificado com o name especificado.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	Nome desse valor dinâmico calculado.
`formula`	`String`	A fórmula usada para calcular esse valor.

Retornar

PivotValue: o PivotValue recém-criado

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addColumnGroup(sourceDataColumn)`

Define um novo agrupamento de colunas dinâmicas na tabela dinâmica. O sourceDataColumn especificado indica a coluna nos dados de origem na qual o agrupamento é baseado.

Parâmetros

Nome	Tipo	Descrição
`sourceDataColumn`	`Integer`	O número da coluna que este grupo resume. Esse índice representa o número absoluto da coluna na planilha. `1` representa a coluna "A," `2` representa a coluna B etc.

Retornar

PivotGroup: o PivotGroup recém-criado

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addFilter(sourceDataColumn, filterCriteria)`

Cria um novo filtro para a tabela dinâmica. O sourceDataColumn especificado indica a coluna nos dados de origem em que esse filtro opera.

Parâmetros

Nome	Tipo	Descrição
`sourceDataColumn`	`Integer`	O número da coluna que este grupo resume. Esse índice representa o número absoluto da coluna na planilha. `1` representa a coluna "A," `2` representa a coluna B etc.
`filterCriteria`	`FilterCriteria`	São os critérios de filtro usados para executar a filtragem.

Retornar

PivotFilter: o PivotFilter recém-criado

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addPivotValue(sourceDataColumn, summarizeFunction)`

Define um novo valor dinâmico na tabela dinâmica com o valor summarizeFunction especificado. A sourceDataColumn especificada indica a coluna nos dados de origem em que o valor é baseado.

Parâmetros

Nome	Tipo	Descrição
`sourceDataColumn`	`Integer`	O número da coluna que este grupo resume. Esse índice representa o número absoluto da coluna na planilha. `1` representa a coluna "A," `2` representa a coluna B etc.
`summarizeFunction`	`PivotTableSummarizeFunction`

Retornar

PivotValue: o PivotValue recém-criado

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addRowGroup(sourceDataColumn)`

Define um novo agrupamento de linhas dinâmicas na tabela dinâmica. O sourceDataColumn especificado indica a coluna nos dados de origem na qual o agrupamento é baseado.

Parâmetros

Nome	Tipo	Descrição
`sourceDataColumn`	`Integer`	O número da coluna que este grupo resume. Esse índice representa o número absoluto da coluna na planilha. `1` representa a coluna "A," `2` representa a coluna B etc.

Retornar

PivotGroup: o PivotGroup recém-criado

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`asDataSourcePivotTable()`

Retorna a tabela dinâmica como uma tabela dinâmica de fonte de dados se a tabela dinâmica estiver vinculada a um DataSource, ou null se não estiver.

Retornar

DataSourcePivotTable: uma tabela dinâmica de fonte de dados.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getAnchorCell()`

Retorna a Range que representa a célula em que a tabela dinâmica está fixada.

Retornar

Range: a célula âncora desta tabela dinâmica

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getColumnGroups()`

Retorna uma lista ordenada dos grupos de colunas nesta tabela dinâmica.

Retornar

PivotGroup[]: os grupos de colunas nesta tabela dinâmica.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFilters()`

Retorna uma lista ordenada dos filtros nesta tabela dinâmica.

Retornar

PivotFilter[]: os filtros nesta tabela dinâmica.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getPivotValues()`

Retorna uma lista ordenada dos valores dinâmicos nesta tabela dinâmica.

Retornar

PivotValue[]: os valores dinâmicos nesta tabela dinâmica.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRowGroups()`

Retorna uma lista ordenada dos grupos de linhas nesta tabela dinâmica.

Retornar

PivotGroup[]: os grupos de linhas nesta tabela dinâmica.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSourceDataRange()`

Retorna o intervalo de dados de origem em que a tabela dinâmica é construída.

Retornar

Range: o intervalo de dados de origem desta tabela dinâmica.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getValuesDisplayOrientation()`

Retorna se os valores são exibidos como linhas ou colunas.

Retornar

Dimension: se os valores são exibidos como linhas ou colunas

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`remove()`

Exclui esta tabela dinâmica. Se houver mais operações nesta tabela dinâmica, ocorrerá um erro.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setValuesDisplayOrientation(dimension)`

Define o layout da tabela dinâmica para mostrar valores como colunas ou linhas.

Parâmetros

Nome	Tipo	Descrição
`dimension`	`Dimension`	A dimensão que indica como exibir valores dinâmicos.

Retornar

PivotTable: a tabela dinâmica para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets