En esta guía, se describe cómo y por qué usar la API de Hojas de cálculo de Google para crear tablas en tus hojas de cálculo.
¿Qué es una tabla?
Con las tablas, puedes simplificar la creación de datos y reducir la necesidad de dar formato, ingresar y actualizar datos de forma repetitiva, ya que aplican de forma automática el formato y la estructura a los rangos de datos.
Las tablas tienen muchas funciones, como encabezados, pies de página, tipos de columnas, filtros, vistas, referencias de tablas y nombres de tablas. Obtén más información en el anuncio de la función y descubre cómo usar tablas en Hojas de cálculo.
Puedes usar tablas para tareas como el seguimiento de proyectos, la planificación de eventos y la administración de inventarios.
Agregue una tabla
Para agregar una tabla, usa el método batchUpdate y proporciona una solicitud addTable. Usa esta solicitud para agregar una tabla a la hoja de cálculo.
En el siguiente ejemplo, se crea una tabla llamada "Project Tracker" en el range especificado con 2 columnas establecidas. Una columna de porcentaje en la primera columna y un tipo de columna desplegable en la segunda.
{
"addTable": {
"table": {
"name": "Project Tracker",
"tableId": "123",
"range": {
"sheetId": 0,
"startColumnIndex": 0,
"endColumnIndex": 5,
"startRowIndex": 0,
"endRowIndex": 5,
},
"columnProperties": [
{
"columnIndex": 0,
"columnName": "Column 1",
"columnType": "PERCENT"
},
{
"columnIndex": 1,
"columnName": "Column 2",
"columnType": "DROPDOWN",
"dataValidationRule": {
"condition": {
"type": "ONE_OF_LIST",
"values": [
{
"userEnteredValue": "Not Started"
},
{
"userEnteredValue": "In Progress"
},
{
"userEnteredValue": "Complete"
}
]
}
}
}
],
}
}
}
Tipos de columnas
Las tablas tienen tipos de columnas, como numérico, fecha, menú desplegable, chip inteligente y casilla de verificación. Los tipos de columnas de calificación y casilla de verificación se completan con los valores predeterminados de 0 y FALSO, respectivamente.
Tipo de columna de menú desplegable
El tipo de columna de menú desplegable crea un menú desplegable de chips. Si un tipo de columna se establece como desplegable, el dataValidationRule de la columna se debe establecer con una condición ONE_OF_LIST. Otros tipos de columnas no deben establecer el campo "dataValidationRule".
Actualiza una tabla
Usa el método spreadsheets.batchUpdate y proporciona un UpdateTableRequest.
Modifica el tamaño de la tabla
Usa el método UpdateTableRequest para modificar el range que tiene la tabla para agregar filas o columnas nuevas.
Si necesitas agregar una fila o columna nueva dentro de la tabla, usa InsertRangeRequest o InsertDimensionRequest.
Si necesitas borrar una fila de una tabla, puedes usar DeleteRangeRequest. De lo contrario, puedes usar DeleteDimensionRequest para borrar una fila completa de la hoja de cálculo.
Activar o desactivar el pie de página de la tabla
Si actualizas una tabla existente sin un pie de página para agregar uno, el range se expande en 1 fila. Si actualizas una tabla existente con un pie de página y lo quitas, range se reducirá en 1 fila.
Cómo agregar valores a una tabla
Usa AppendCellsRequest con tableId para agregar filas al final de una tabla. Esto agrega los valores a la primera fila libre y reconoce las filas y los pies de página completos. Si no hay filas vacías, se insertan filas al final de la tabla y antes de cualquier pie de página, si corresponde.
Borra una tabla
Usa el método spreadsheets.batchUpdate y proporciona un DeleteTableRequest.
Usa DeleteTableRequest para borrar toda la tabla y su contenido.
Usa DeleteBandingRequest para quitar el formato de la tabla, pero conserva los datos.
Usa tablas con otras funciones de Hojas de cálculo
Otras funciones de la API que admiten tablas como sus datos de respaldo incluyen filtros, vistas de filtros y rangos protegidos.