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