借助 Google Sheets API,您可以在 表格。本页中的示例说明了如何将一些常见的行和列 操作。
这些示例以 HTTP 请求的形式呈现, 中性。了解如何使用 请参阅更新 电子表格。
在这些示例中,占位符 SPREADSHEET_ID
和 SHEET_ID
指明提供这些 ID 的位置。您可以在电子表格
ID。您可以获得
工作表 ID
spreadsheets.get
方法。通过
范围使用 A1 表示法指定。一个
示例范围是“Sheet1!A1:D5”。
调整列宽或行高
以下
spreadsheets.batchUpdate
代码示例展示了如何使用
UpdateDimensionPropertiesRequest
将 A 列的宽度属性更新为 160 像素。第二个请求更新
将前三行的行高属性设置为 40 像素。dimension
字段决定了操作是否适用于
工作表。
请求协议如下所示。
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "updateDimensionProperties": { "range": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 0, "endIndex": 1 }, "properties": { "pixelSize": 160 }, "fields": "pixelSize" } }, { "updateDimensionProperties": { "range": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 0, "endIndex": 3 }, "properties": { "pixelSize": 40 }, "fields": "pixelSize" } } ] }
附加空行或空列
以下
spreadsheets.batchUpdate
代码示例展示了如何使用
AppendDimensionRequest
来附加行和列。第一个请求会将三个空行
而第二个函数则会附加一个空列。dimension
字段决定了操作是否适用于
工作表。
请求协议如下所示。
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "appendDimension": { "sheetId":SHEET_ID
, "dimension": "ROWS", "length": 3 } }, { "appendDimension": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "length": 1 } } ] }
自动调整列的大小
以下
spreadsheets.batchUpdate
代码示例展示了如何使用
AutoResizeDimensionsRequest
根据列内容的大小调整 A:C 列的大小。dimension
字段指示操作适用于工作表的列。
请求协议如下所示。
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID
,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
自动调整行高
以下
spreadsheets.batchUpdate
代码示例展示了如何使用
AutoResizeDimensionsRequest
以清除前三行的行高。行高随即增加
根据每行中单元格的内容动态变化。dimension
字段指示操作适用于工作表中的行。
请求协议如下所示。
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID
,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
删除行或列
以下
spreadsheets.batchUpdate
代码示例展示了如何使用
DeleteDimensionRequest
删除工作表中的前三行。第二个请求会删除 B:D 列。
dimension
字段决定了该操作是应用于列还是应用于列
表格的行。
请求协议如下所示。
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "deleteDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 0, "endIndex": 3 } } }, { "deleteDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 1, "endIndex": 4 } } }, ], }
插入空行或空列
以下
spreadsheets.batchUpdate
代码示例展示了如何使用
InsertDimensionRequest
在特定索引处插入列或行(例如在前面加上空行)
)。第一个请求在 C 列处插入两个空列。
第二个请求从第 1 行开始插入三个空行。
dimension
字段决定了该操作是应用于列还是应用于列
表格的行。
如果为 true,inheritFromBefore
字段会告知 Sheets API 提供
新的列或行与上一行或上列的属性相同,并且如果
false,沿用新列或新行后面的维度。
如果在第 1 行或第 1 列插入 1 行,则 inheritFromBefore
不能为 true
A 列。
请求协议如下所示。
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "insertDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 2, "endIndex": 4 }, "inheritFromBefore": true } }, { "insertDimension": { "range": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 0, "endIndex": 3 }, "inheritFromBefore": false } }, ], }
移动行或列
以下
spreadsheets.batchUpdate
代码示例展示了如何使用
MoveDimensionRequest
将 A 列移动到 D 列的位置。第二个请求移动行
从第 5–10 行移至第 20 行的位置。
dimension
字段决定了该操作是应用于列还是应用于列
表格的行。destinationIndex
字段用于确定将
源数据。
请求协议如下所示。
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "moveDimension": { "source": { "sheetId":SHEET_ID
, "dimension": "COLUMNS", "startIndex": 0, "endIndex": 1 }, "destinationIndex": 3 } }, { "moveDimension": { "source": { "sheetId":SHEET_ID
, "dimension": "ROWS", "startIndex": 4, "endIndex": 10 }, "destinationIndex": 19 } }, ], }