本指南說明如何使用 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 功能包括篩選器、篩選器檢視畫面和受保護的範圍。