Se usó la API de Cloud Translation para traducir esta página.

Class PivotGroup

Acceder y modificar grupos de desglose de tablas dinámicas

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`addManualGroupingRule(groupName, groupMembers)`	`PivotGroup`	Agrega una regla de agrupación manual para este grupo de elementos de tabla dinámica.
`areLabelsRepeated()`	`Boolean`	Muestra si las etiquetas se muestran como repetidas.
`clearGroupingRule()`	`PivotGroup`	Quita las reglas de agrupación de este grupo de elementos de tabla dinámica.
`clearSort()`	`PivotGroup`	Quita cualquier orden aplicado a este grupo.
`getDateTimeGroupingRule()`	`DateTimeGroupingRule`	Muestra la regla de agrupación de fecha y hora en el grupo dinámico o `null` si no se estableció ninguna regla de agrupación por fecha y hora.
`getDimension()`	`Dimension`	Muestra si se trata de un grupo de filas o columnas.
`getGroupLimit()`	`PivotGroupLimit`	Muestra el límite del grupo de elementos de tabla dinámica.
`getIndex()`	`Integer`	Muestra el índice de este grupo de tabla dinámica en el orden actual del grupo.
`getPivotTable()`	`PivotTable`	Muestra el `PivotTable` al que pertenece esta agrupación.
`getSourceDataColumn()`	`Integer`	Muestra la cantidad de columnas de datos de origen que resume este grupo.
`getSourceDataSourceColumn()`	`DataSourceColumn`	Muestra la columna de fuente de datos en la que opera el grupo de elementos de tabla dinámica.
`hideRepeatedLabels()`	`PivotGroup`	Oculta las etiquetas repetidas de esta agrupación.
`isSortAscending()`	`Boolean`	Muestra `true` si el orden es ascendente, muestra `false` si el orden es descendente.
`moveToIndex(index)`	`PivotGroup`	Mueve este grupo a la posición especificada en la lista actual de grupos de filas o columnas.
`remove()`	`void`	Quita este grupo de tabla dinámica de la tabla.
`removeManualGroupingRule(groupName)`	`PivotGroup`	Quita la regla de agrupación manual con el `groupName` especificado.
`resetDisplayName()`	`PivotGroup`	Restablece el nombre visible de este grupo en la tabla dinámica a su valor predeterminado.
`setDateTimeGroupingRule(dateTimeGroupingRuleType)`	`PivotGroup`	Establece la regla de agrupación de fecha y hora en el grupo de tabla dinámica.
`setDisplayName(name)`	`PivotGroup`	Establece el nombre comercial de este grupo en la tabla dinámica.
`setGroupLimit(countLimit)`	`PivotGroup`	Establece el límite del grupo de elementos de tabla dinámica.
`setHistogramGroupingRule(minValue, maxValue, intervalSize)`	`PivotGroup`	Establece una regla de agrupación de histogramas para este grupo de tabla dinámica.
`showRepeatedLabels()`	`PivotGroup`	Cuando hay más de una agrupación de filas o columnas, este método muestra la etiqueta de esta agrupación para cada entrada de la agrupación siguiente.
`showTotals(showTotals)`	`PivotGroup`	Establece si se deben mostrar los valores totales para este grupo de tabla dinámica en la tabla.
`sortAscending()`	`PivotGroup`	Establece el orden ascendente como ascendente.
`sortBy(value, oppositeGroupValues)`	`PivotGroup`	Ordena este grupo según la `PivotValue` especificada para los valores de `oppositeGroupValues`.
`sortDescending()`	`PivotGroup`	Configura el orden de clasificación como descendente.
`totalsAreShown()`	`Boolean`	Muestra si los valores totales se muestran actualmente para este grupo de tabla dinámica.

Documentación detallada

`addManualGroupingRule(groupName, groupMembers)`

Agrega una regla de agrupación manual para este grupo de elementos de tabla dinámica.

Parámetros

Nombre	Tipo	Descripción
`groupName`	`String`	El nombre de esta regla de agrupación.
`groupMembers`	`Object[]`	Los valores que se incluyen en esta regla de agrupación.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`areLabelsRepeated()`

Muestra si las etiquetas se muestran como repetidas.

Volver

Boolean: true si se repiten las etiquetas; de lo contrario, muestra false.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`clearGroupingRule()`

Quita las reglas de agrupación de este grupo de elementos de tabla dinámica.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`clearSort()`

Quita cualquier orden aplicado a este grupo.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getDateTimeGroupingRule()`

Muestra la regla de agrupación de fecha y hora en el grupo dinámico o null si no se estableció ninguna regla de agrupación por fecha y hora.

Volver

DateTimeGroupingRule: la regla de agrupación de fecha y hora.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getDimension()`

Muestra si se trata de un grupo de filas o columnas.

Volver

Dimension: la dimensión que representa este tipo de grupo

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getGroupLimit()`

Muestra el límite del grupo de elementos de tabla dinámica. Muestra null si no se establece ningún límite de grupo de elementos de tabla dinámica.

Volver

PivotGroupLimit: el límite de grupos de tabla dinámica.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getIndex()`

Muestra el índice de este grupo de tabla dinámica en el orden actual del grupo.

Volver

Integer: el índice del grupo de elementos de tabla dinámica

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getPivotTable()`

Muestra el PivotTable al que pertenece esta agrupación.

Volver

PivotTable: Es la tabla dinámica a la que pertenece este grupo.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getSourceDataColumn()`

Muestra la cantidad de columnas de datos de origen que resume este grupo. Este índice se basa en 1 y, si este grupo resume los datos de origen en la columna “A” de la hoja de cálculo, este método muestra 1.

Volver

Integer: Es el número de columna de datos de origen.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getSourceDataSourceColumn()`

Muestra la columna de fuente de datos en la que opera el grupo de elementos de tabla dinámica. Muestra null si la tabla dinámica no es una {DataSourcePivotTableApi}.

Volver

DataSourceColumn: la columna de fuente de datos en la que opera el grupo de tabla dinámica.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`hideRepeatedLabels()`

Oculta las etiquetas repetidas de esta agrupación. Si las etiquetas ya están ocultas, esto genera una no-op. Si se llama a este método antes de que haya varias agrupaciones de filas o columnas, cuando se agrega una agrupación adicional, se ocultan las etiquetas repetidas.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`isSortAscending()`

Muestra true si el orden es ascendente, muestra false si el orden es descendente.

Volver

Boolean: true si el orden de clasificación es ascendente.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`moveToIndex(index)`

Mueve este grupo a la posición especificada en la lista actual de grupos de filas o columnas. Estos índices se basan en 0. Por ejemplo, si este grupo debe moverse a la primera posición, se debe llamar a este método con 0.

Parámetros

Nombre	Tipo	Descripción
`index`	`Integer`	El índice al que se moverá la agrupación.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`remove()`

Quita este grupo de tabla dinámica de la tabla.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`removeManualGroupingRule(groupName)`

Quita la regla de agrupación manual con el groupName especificado.

Parámetros

Nombre	Tipo	Descripción
`groupName`	`String`	El nombre de la regla de agrupación que se quitará.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`resetDisplayName()`

Restablece el nombre visible de este grupo en la tabla dinámica a su valor predeterminado.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`setDateTimeGroupingRule(dateTimeGroupingRuleType)`

Establece la regla de agrupación de fecha y hora en el grupo de tabla dinámica.

Para quitar la regla, usa clearGroupingRule().

Parámetros

Nombre	Tipo	Descripción
`dateTimeGroupingRuleType`	`DateTimeGroupingRuleType`	El tipo de regla que se establecerá.

Volver

PivotGroup: Es el grupo de elementos dinámicos para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`setDisplayName(name)`

Establece el nombre comercial de este grupo en la tabla dinámica.

Parámetros

Nombre	Tipo	Descripción
`name`	`String`	El nombre visible que se establecerá.

Volver

PivotGroup: Es el grupo de pivot para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`setGroupLimit(countLimit)`

Establece el límite del grupo de elementos de tabla dinámica. La operación solo es compatible con DataSourcePivotTable.

Parámetros

Nombre	Tipo	Descripción
`countLimit`	`Integer`	El límite de recuento de filas o columnas que se establecerán. Debe ser un número positivo.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`setHistogramGroupingRule(minValue, maxValue, intervalSize)`

Establece una regla de agrupación de histogramas para este grupo de tabla dinámica. Una regla de histograma organiza los valores en una columna de datos de origen en depósitos de un tamaño constante. Todos los valores del minValue al maxValue se colocan en grupos del tamaño interval. Todos los valores inferiores a minValue se colocan en un bucket, al igual que todos los valores mayores que maxValue.

Parámetros

Nombre	Tipo	Descripción
`minValue`	`Integer`	El valor mínimo para los elementos que se colocarán en depósitos. Los valores inferiores a este se combinan en un solo bucket.
`maxValue`	`Integer`	El valor máximo de los elementos que se colocarán en segmentos. Los valores mayores que este se combinan en un solo bucket.
`intervalSize`	`Integer`

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`showRepeatedLabels()`

Cuando hay más de una agrupación de filas o columnas, este método muestra la etiqueta de esta agrupación para cada entrada de la agrupación siguiente. Si las etiquetas ya se repiten, esto genera una no-op. Si se llama a este método antes de que haya varias agrupaciones de filas o columnas, cuando se agrega una agrupación adicional, se muestran etiquetas repetidas.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`showTotals(showTotals)`

Establece si se deben mostrar los valores totales para este grupo de tabla dinámica en la tabla.

Parámetros

Nombre	Tipo	Descripción
`showTotals`	`Boolean`	Si se muestran los totales o no.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`sortAscending()`

Establece el orden ascendente como ascendente.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`sortBy(value, oppositeGroupValues)`

Ordena este grupo según la PivotValue especificada para los valores de oppositeGroupValues.

// Sorts the item group by the "SUM of Quantity" pivot value for the specified salespersons.
var sheet = SpreadsheetApp.getActiveSheet();
var pivotTable = sheet.getPivotTables()[0];
var itemGroup = pivotTable.getRowGroups()[0];
var sumQuantityValue = pivotTable.getPivotValues()[0];
itemGroup.sortBy(sumQuantityValue, ['Beth', 'Amir', 'Devyn']);

Parámetros

Nombre	Tipo	Descripción
`value`	`PivotValue`	El valor de tabla dinámica que se debe ordenar.
`oppositeGroupValues`	`Object[]`	Los valores de un grupo dinámico opuesto (un grupo de columnas si ordenas un grupo de filas o un grupo de filas si ordenas un grupo de columnas) que se usan para ordenar los datos. El orden de estos valores determina la prioridad para el empate.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`sortDescending()`

Configura el orden de clasificación como descendente.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`totalsAreShown()`

Muestra si los valores totales se muestran actualmente para este grupo de tabla dinámica.

Volver

Boolean: true si se muestran los valores totales para este grupo de tabla dinámica; de lo contrario, muestra false.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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