此页面由 Cloud Translation API 翻译。

表

本指南介绍了如何以及为何使用 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。

下拉菜单列类型

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

更新表

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

修改表格大小

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

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

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

切换表格页脚

如果您要更新不带页脚的现有表格以添加页脚，则 range 会扩展 1 行。如果您更新带有页脚的现有表并移除页脚，range 会缩减 1 行。

将值附加到表

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

删除表

使用 spreadsheets.batchUpdate 方法并提供 DeleteTableRequest。使用 DeleteTableRequest 删除整个表及其内容。

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