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 repetidamente, ya que se 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 y nombres. Obtén más información en el anuncio de la función y aprende a 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 del inventario.
Agregue una tabla
Para agregar una tabla, usa el método batchUpdate y proporciona una solicitud addTable. Usas 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 de menú desplegable en la segunda columna.
{ "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éricas, de fecha, de menú desplegable, de chip inteligente y de casilla de verificación. Los tipos de columna de calificación y casilla de verificación se completan con los valores predeterminados 0 y FALSE, respectivamente.
Tipo de columna de menú desplegable
El tipo de columna de menú desplegable crea un menú desplegable de chips. Si el tipo de columna se establece como menú desplegable, el dataValidationRule de la columna debe establecerse 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.
Cómo modificar 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 la 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 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 quitas el pie de página, el range se reduce en 1 fila.
Cómo agregar valores a una tabla
Usa AppendCellsRequest con tableId para agregar filas al final de una tabla. Esta función agrega los valores a la primera fila libre y tiene en cuenta las filas completas y los pies de página. 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 conservar los datos.
Usa tablas con otras funciones de Hojas de cálculo
Otras funciones de la API que admiten que las tablas sean sus datos de respaldo incluyen filtros, vistas filtradas y rangos protegidos.