借助 Google 表格 API，您可以通过多种方式操作电子表格中的数据。用户通过 Google 表格界面执行的大多数操作也可以通过 Google 表格 API 执行。本页中的示例展示了如何使用 Sheets API 执行一些常见的电子表格操作。
这些示例以 HTTP 请求的形式呈现，以便不受语言限制。如需了解如何使用 Google API 客户端库以不同语言实现批量更新，请参阅更新电子表格。
在这些示例中，占位符 SPREADSHEET_ID 和 SHEET_ID 表示您应在何处提供这些 ID。您可以在电子表格网址中找到电子表格 ID。您可以使用 spreadsheets.get 方法获取工作表 ID。范围使用 A1 表示法指定。示例范围为 Sheet1!A1:D5。
对范围应用数据验证
以下 spreadsheets.batchUpdate 代码示例展示了如何使用 SetDataValidationRequest 将数据验证规则（其中“值 > 5”）应用于 A1:D10 范围中的每个单元格。
请求协议如下所示。
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"setDataValidation": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 4
},
"rule": {
"condition": {
"type": "NUMBER_GREATER",
"values": [
{
"userEnteredValue": "5"
}
]
},
"inputMessage": "Value must be > 5",
"strict": true
}
}
}
]
}复制和粘贴单元格格式
以下 spreadsheets.batchUpdate 代码示例展示了如何使用 CopyPasteRequest 仅复制 A1:D10 范围的格式设置，并将其粘贴到同一工作表中的 F1:I10 范围。该方法将 PasteType 枚举与 PASTE_FORMAT 结合使用，仅用于粘贴格式设置和数据验证。A1:D10 中的原始值保持不变。
请求协议如下所示。
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"copyPaste": {
"source": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 4
},
"destination": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 5,
"endColumnIndex": 9
},
"pasteType": "PASTE_FORMAT",
"pasteOrientation": "NORMAL"
}
}
]
}剪切和粘贴单元格
以下 spreadsheets.batchUpdate 代码示例展示了如何使用 CutPasteRequest。它会剪裁范围 A1:D10，并使用 PasteType 枚举与 PASTE_NORMAL 一起粘贴其值、公式、格式，并合并到同一工作表中的 F1:I10 范围。原始来源范围单元格内容会被移除。
请求协议如下所示。
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"cutPaste": {
"source": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 4
},
"destination": {
"sheetId": SHEET_ID,
"rowIndex": 0,
"columnIndex": 5
},
"pasteType": "PASTE_NORMAL"
}
}
]
}对范围重复使用公式
以下 spreadsheets.batchUpdate 代码示例展示了如何使用 RepeatCellRequest 将公式 =FLOOR(A1*PI()) 复制到范围 B1:D10。公式的范围会自动递增，从左上角单元格开始，递增到范围中的每一行和列。例如，单元格 B1 的公式为 =FLOOR(A1*PI())，而单元格 D6 的公式为 =FLOOR(C6*PI())。
请求协议如下所示。
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"repeatCell": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 1,
"endColumnIndex": 4
},
"cell": {
"userEnteredValue": {
"formulaValue": "=FLOOR(A1*PI())"
}
},
"fields": "userEnteredValue"
}
}
]
}按多个排序规范对范围进行排序
以下 spreadsheets.batchUpdate 代码示例展示了如何使用 SortRangeRequest 对 A1:D10 范围进行排序，首先按 B 列升序排序，然后按 C 列降序排序，最后按 D 列降序排序。
请求协议如下所示。
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"sortRange": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 4
},
"sortSpecs": [
{
"dimensionIndex": 1,
"sortOrder": "ASCENDING"
},
{
"dimensionIndex": 2,
"sortOrder": "DESCENDING"
},
{
"dimensionIndex": 3,
"sortOrder": "DESCENDING"
}
]
}
}
]
}