資料表

本指南說明如何使用 Google 試算表 API 在試算表中建立表格，以及相關原因。

什麼是資料表？

只需使用表格功能，讓系統自動對指定範圍內的資料套用格式與結構，即可輕鬆建立資料，減少重覆設定格式、輸入內容及更新資料的次數。

表格有許多功能，例如標頭、頁尾、欄型、篩選器、檢視畫面、表格參照和表格名稱。請參閱功能發布公告，進一步瞭解相關資訊，並瞭解如何在試算表中使用表格。

您可以使用表格來處理專案追蹤、活動規劃和商品目錄管理等工作。

新增表格

如要新增資料表，請使用 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 列。

將值附加到表格

搭配 tableId 使用 AppendCellsRequest，即可在資料表結尾新增資料列。這會將值附加到第一個空白資料列，並瞭解完整的資料列和頁尾。如果沒有空白資料列，這項操作會將資料列插入表格結尾，以及任何頁尾之前 (如適用)。

刪除資料表

請使用 spreadsheets.batchUpdate 方法，並提供 DeleteTableRequest。使用 DeleteTableRequest 刪除整個資料表和資料表的內容。

使用 DeleteBandingRequest 移除表格格式，但保留資料。

搭配其他試算表功能使用表格

其他支援資料表做為其備援資料的 API 功能包括篩選器、篩選器檢視畫面和受保護的範圍。