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

Class DataSource

Acceder y modificar la fuente de datos existente Para crear una tabla de fuente de datos con una fuente de datos nueva, consulta DataSourceTable.

Usa esta clase solo con datos que estén conectados a una base de datos.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`createCalculatedColumn(name, formula)`	`DataSourceColumn`	Crea una columna calculada.
`createDataSourcePivotTableOnNewSheet()`	`DataSourcePivotTable`	Crea una tabla dinámica de fuente de datos a partir de esta fuente de datos en la primera celda de una hoja nueva.
`createDataSourceTableOnNewSheet()`	`DataSourceTable`	Crea una tabla de fuente de datos a partir de esta fuente de datos en la primera celda de una hoja nueva.
`getCalculatedColumnByName(columnName)`	`DataSourceColumn`	Muestra la columna calculada en la fuente de datos que coincide con el nombre de la columna.
`getCalculatedColumns()`	`DataSourceColumn[]`	Muestra todas las columnas calculadas en la fuente de datos.
`getColumns()`	`DataSourceColumn[]`	Muestra todas las columnas de la fuente de datos.
`getDataSourceSheets()`	`DataSourceSheet[]`	Muestra las hojas de la fuente de datos asociadas con esta fuente de datos.
`getSpec()`	`DataSourceSpec`	Obtiene la especificación de la fuente de datos.
`refreshAllLinkedDataSourceObjects()`	`void`	Actualiza todos los objetos de fuente de datos vinculados a la fuente de datos.
`updateSpec(spec)`	`DataSource`	Actualiza la especificación de la fuente de datos y actualiza los objetos de la fuente de datos vinculados con esta fuente de datos con la especificación nueva.
`updateSpec(spec, refreshAllLinkedObjects)`	`DataSource`	Actualiza la especificación de fuente de datos y actualiza el `data source sheets` vinculado con la nueva especificación.
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	Espera hasta que se completen todas las ejecuciones actuales de los objetos de fuente de datos vinculados; el tiempo de espera se agota después de la cantidad de segundos proporcionada.

Documentación detallada

`createCalculatedColumn(name, formula)`

Crea una columna calculada.

Parámetros

Nombre	Tipo	Descripción
`name`	`String`	El nombre de la columna calculada.
`formula`	`String`	La fórmula de columna calculada.

Devolvedor

DataSourceColumn: Es la columna calculada recién creada.

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

`createDataSourcePivotTableOnNewSheet()`

Crea una tabla dinámica de fuente de datos a partir de esta fuente de datos en la primera celda de una hoja nueva. Como efecto secundario, la hoja nueva se convierte en la hoja activa.

Devolvedor

DataSourcePivotTable: Es la tabla dinámica de la fuente de datos recién creada.

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

`createDataSourceTableOnNewSheet()`

Crea una tabla de fuente de datos a partir de esta fuente de datos en la primera celda de una hoja nueva. Como efecto secundario, la nueva hoja se convierte en la hoja activa.

Devolvedor

DataSourceTable: Es la tabla de fuente de datos recién creada.

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

`getCalculatedColumnByName(columnName)`

Muestra la columna calculada en la fuente de datos que coincide con el nombre de la columna.

Parámetros

Nombre	Tipo	Descripción
`columnName`	`String`	El nombre de la columna calculada que se obtendrá.

Devolvedor

DataSourceColumn: Es la columna calculada que coincide con el nombre de la columna, o bien null si no existe esa columna calculada.

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

`getCalculatedColumns()`

Muestra todas las columnas calculadas en la fuente de datos.

Devolvedor

DataSourceColumn[]: Es un array de todas las columnas calculadas en 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

`getColumns()`

Muestra todas las columnas de la fuente de datos.

Devolvedor

DataSourceColumn[]: Es un array de todos los DataSourceColumn de 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

`getDataSourceSheets()`

Muestra las hojas de la fuente de datos asociadas con esta fuente de datos.

Devolvedor

DataSourceSheet[]: Es un array de hojas de 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

`getSpec()`

Obtiene la especificación de la fuente de datos.

Devolvedor

DataSourceSpec: Es la especificación de 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

`refreshAllLinkedDataSourceObjects()`

Actualiza todos los objetos de fuente de datos vinculados a la fuente de datos.

Muestra una excepción si el tipo de fuente de datos no está habilitado Usa los métodos SpreadsheetApp#enable...Execution() a fin de habilitar la ejecución de datos para el tipo específico de 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

`updateSpec(spec)`

Actualiza la especificación de la fuente de datos y actualiza los objetos de la fuente de datos vinculados con esta fuente de datos con la especificación nueva.

Parámetros

Nombre	Tipo	Descripción
`spec`	`DataSourceSpec`	La especificación de fuente de datos con la que se actualizará.

Devolvedor

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

`updateSpec(spec, refreshAllLinkedObjects)`

Actualiza la especificación de fuente de datos y actualiza el data source sheets vinculado con la nueva especificación.

Parámetros

Nombre	Tipo	Descripción
`spec`	`DataSourceSpec`	La especificación de fuente de datos con la que se actualizará.
`refreshAllLinkedObjects`	`Boolean`	Si es `true`, también actualiza todos los objetos de la fuente de datos vinculados con esta fuente de datos.

Devolvedor

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

`waitForAllDataExecutionsCompletion(timeoutInSeconds)`

Espera hasta que se completen todas las ejecuciones actuales de los objetos de fuente de datos vinculados; el tiempo de espera se agota después de la cantidad de segundos proporcionada. Muestra una excepción si las ejecuciones no se completan cuando se agota el tiempo de espera, pero no cancela las ejecuciones de datos.

Parámetros

Nombre	Tipo	Descripción
`timeoutInSeconds`	`Integer`	El tiempo de espera para las ejecuciones de datos, en segundos. El máximo es 300 segundos.

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