表

本指南介绍如何以及为何使用 Google 表格 API 在电子表格中创建表格。

什么是表格？

借助表格，您可以自动为数据范围应用格式和结构，从而简化数据创建过程，减少重复设置数据格式、输入和更新数据的需要。

表格具有许多功能，例如表头、表尾、列类型、过滤器、视图、表格引用和表格名称。如需了解详情，请参阅 功能公告 ，并了解如何在 Google 表格中使用表格。

您可以使用表格来完成项目跟踪、活动规划和产品目录管理系统等任务。

添加表格

如需添加表格，请使用 batchUpdate 方法，并提供 addTable 请求。您可以使用此请求向电子表格添加表格。

以下示例会在指定的 range 中创建一个名为“Project Tracker”的表格，其中包含 2 个已设置的列。第一列是百分比列，第二列是下拉菜单列类型。

{
  "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"
                }
              ]
            }
          }
        }
      ],
    }
  }
}

列类型

表格具有多种列类型 ，例如数字、日期、下拉菜单、智能条状标签和复选框。评分和复选框列类型分别填充默认值 0 和 FALSE。

下拉菜单列类型会创建条状标签下拉菜单。如果列类型设置为下拉菜单，则必须为该列设置 dataValidationRule，并使用 ONE_OF_LIST 条件。其他列类型不应设置 `dataValidationRule` 字段。

更新表格

使用 spreadsheets.batchUpdate 方法，并提供 UpdateTableRequest。

修改表格大小

使用 UpdateTableRequest 方法修改表格必须添加新行/列的 range。

如果您需要在表格中添加新行或新列，请使用 InsertRangeRequest 或 InsertDimensionRequest

如果您需要删除表格行，可以使用 DeleteRangeRequest 否则，可以使用 DeleteDimensionRequest 从电子表格中删除整行。

如果您要更新没有页脚的现有表格以添加页脚，则 range 会增加 1 行。如果您要更新有页脚的现有表格并移除页脚，则 range 会减少 1 行。

向表格附加值

使用 AppendCellsRequest 和 tableId 向表格末尾添加行。这会将值附加到第一个空闲行，并识别完整行和页脚。如果没有空行，则此操作会将行插入到表格末尾和任何页脚之前（如果适用）。

删除表格

使用 spreadsheets.batchUpdate 方法，并提供 DeleteTableRequest。 使用 DeleteTableRequest 删除整个表格和表格内容。

使用 DeleteBandingRequest 移除表格格式，但保留数据。

将表格与其他 Google 表格功能搭配使用

其他支持表格作为其支持数据的 API 功能包括 过滤器、 过滤视图和 受保护的范围。