Tablas

En esta guía, se describe cómo y por qué usar la API de Google Sheets 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 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 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 batchUpdate método 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 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 columna

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 propagan con los valores predeterminados 0 y FALSE, respectivamente.

El tipo de columna de menú desplegable crea un menú desplegable de chip. Si un tipo de columna se establece como menú desplegable, se debe configurar el dataValidationRule de la columna con una condición ONE_OF_LIST. Otros tipos de columnas no deben establecer el campo `dataValidationRule.

Actualiza una tabla

Usa el spreadsheets.batchUpdate método y proporciona un UpdateTableRequest.

Modifica el tamaño de la tabla

Usa el método UpdateTableRequest para modificar el range que debe tener la tabla para agregar filas o columnas nuevas.

Si necesitas agregar una fila o columna nueva dentro de la tabla, usa el InsertRangeRequest o el 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.

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, el range se reduce en 1 fila.

Agrega 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 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 spreadsheets.batchUpdate método 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 de filtro, y rangos protegidos.