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

Class DataSourcePivotTable

Acceder a la tabla dinámica de la fuente de datos existente y modificarla. Para crear una nueva tabla dinámica de fuente de datos, usa Range.createDataSourcePivotTable(dataSource)

Usa esta clase solo con datos conectados a una base de datos.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`addColumnGroup(columnName)`	`PivotGroup`	Agrega un nuevo grupo de columnas dinámicas basado en la columna de fuente de datos especificada.
`addFilter(columnName, filterCriteria)`	`PivotFilter`	Agrega un filtro nuevo basado en la columna de fuente de datos especificada con los criterios de filtro especificados.
`addPivotValue(columnName)`	`PivotValue`	Agrega un nuevo valor de tabla dinámica basado en la columna de fuente de datos especificada sin ningún resumen .
`addPivotValue(columnName, summarizeFunction)`	`PivotValue`	Agrega un nuevo valor de tabla dinámica basado en la columna de fuente de datos especificada con el valor de resumen especificado .
`addRowGroup(columnName)`	`PivotGroup`	Agrega un nuevo grupo de filas de la tabla dinámica según la columna de la fuente de datos especificada.
`asPivotTable()`	`PivotTable`	Muestra la tabla dinámica de la fuente de datos como un objeto de tabla dinámica normal.
`cancelDataRefresh()`	`DataSourcePivotTable`	Cancela la actualización de datos asociada a este objeto si se está ejecutando.
`forceRefreshData()`	`DataSourcePivotTable`	Actualiza los datos de este objeto independientemente del estado actual.
`getDataSource()`	`DataSource`	Obtiene la fuente de datos a la que está vinculado el objeto.
`getStatus()`	`DataExecutionStatus`	Obtiene el estado de ejecución de los datos del objeto.
`refreshData()`	`DataSourcePivotTable`	Actualiza los datos del objeto.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	Espera hasta que se complete la ejecución actual y se agote el tiempo de espera después de la cantidad de segundos proporcionada.

Documentación detallada

`addColumnGroup(columnName)`

Agrega un nuevo grupo de columnas de la tabla dinámica según la columna de la fuente de datos especificada.

Parámetros

Nombre	Tipo	Descripción
`columnName`	`String`	El nombre de la columna de la fuente de datos en el que se basa el grupo de elementos de tabla dinámica.

Volver

PivotGroup: Es el nuevo 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

`addFilter(columnName, filterCriteria)`

Agrega un filtro nuevo basado en la columna de fuente de datos especificada con los criterios de filtro especificados.

Parámetros

Nombre	Tipo	Descripción
`columnName`	`String`	El nombre de columna de la fuente de datos en el que se basa el filtro.
`filterCriteria`	`FilterCriteria`	Son los criterios que usa el filtro.

Volver

PivotFilter: Es el filtro nuevo.

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

`addPivotValue(columnName)`

Agrega un nuevo valor de tabla dinámica basado en la columna de fuente de datos especificada sin ningún resumen . Solo para medidas de Looker.

En el siguiente código, se muestra cómo puedes agregar una medición de Looker como valor dinámico.

// TODO(developer): Replace with your spreadsheet ID which has a Looker data source.
var spreadsheet = SpreadsheetApp.openById("abcd1234")
var datasource = spreadsheet.getDataSources()[0];
var pivotTable = datasource.createDataSourcePivotTableOnNewSheet();

pivotTable.addPivotValue("columnName");

Este método solo está disponible para las fuentes de datos de Looker.

Parámetros

Nombre	Tipo	Descripción
`columnName`	`String`	El nombre de la columna de la fuente de datos en el que se basa el valor dinámico.

Volver

PivotValue: Es el nuevo valor de eje.

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

`addPivotValue(columnName, summarizeFunction)`

Agrega un nuevo valor de tabla dinámica basado en la columna de fuente de datos especificada con el valor de resumen especificado .

Para agregar valores dinámicos para las mediciones de Looker, usa addPivotValue(columnName).

Parámetros

Nombre	Tipo	Descripción
`columnName`	`String`	El nombre de la columna de la fuente de datos en el que se basa el valor dinámico.
`summarizeFunction`	`PivotTableSummarizeFunction`	La función de resumen que usa el valor dinámico.

Volver

PivotValue: Es el nuevo valor 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

`addRowGroup(columnName)`

Agrega un nuevo grupo de filas de tabla dinámica basado en la columna de fuente de datos especificada.

Parámetros

Nombre	Tipo	Descripción
`columnName`	`String`	El nombre de la columna de la fuente de datos en el que se basa el grupo de elementos de tabla dinámica.

Volver

PivotGroup: Es el nuevo 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

`asPivotTable()`

Muestra la tabla dinámica de la fuente de datos como un objeto de tabla dinámica normal.

Volver

PivotTable: Es la 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

`cancelDataRefresh()`

Cancela la actualización de datos asociada a este objeto si se está ejecutando.

En este ejemplo, se muestra cómo cancelar la actualización de una fórmula.

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

Arroja una excepción si el tipo de fuente de datos no está habilitado. Usar métodos SpreadsheetApp#enable...Execution() para habilitar la ejecución de datos para una fuente de datos específica el tipo de letra.

Volver

DataSourcePivotTable: Es el objeto de datos.

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

`forceRefreshData()`

Actualiza los datos de este objeto sin importar el estado actual. Consulta refreshData() para obtener más detalles. Si deseas cancelar una actualización en ejecución de este objeto, consulta cancelDataRefresh().

Volver

DataSourcePivotTable: Es el objeto de datos.

Autorización

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

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

`getDataSource()`

Obtiene la fuente de datos a la que está vinculado el objeto.

Volver

DataSource: Es la fuente de datos.

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

`getStatus()`

Obtiene el estado de ejecución de los datos del objeto.

Volver

DataExecutionStatus: Es el estado de ejecución de los datos.

Autorización

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

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

`refreshData()`

Actualiza los datos del objeto.

Muestra una excepción si se encuentra en el estado error. Usa DataSource#updateSpec() para actualizar la especificación. El método es se prefiere en lugar de forceRefreshData() para evitar ediciones inesperadas en la fuente de datos.

Volver

DataSourcePivotTable: Es el objeto de datos.

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

`waitForCompletion(timeoutInSeconds)`

Espera hasta que se complete la ejecución actual. El tiempo de espera se agota después de la cantidad de segundos proporcionada. Muestra una excepción si la ejecución no se completa cuando se agota el tiempo de espera, pero no cancela ejecución de los datos.

Parámetros

Nombre	Tipo	Descripción
`timeoutInSeconds`	`Integer`	El tiempo que se debe esperar para la ejecución de los datos, en segundos. El máximo es 300 segundos.

Volver

DataExecutionStatus: Es el estado de ejecución de los datos.

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