此页面由 Cloud Translation API 翻译。

表

本指南介绍了如何以及为何使用 Google Sheets 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 移除表格格式，但保留数据。