資料表

本指南說明如何使用 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 移除表格格式，但保留資料。

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

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