借助 Google Sheets API，您可以向单元格、范围、范围集以及整个工作表写入值和公式。本页面上的示例说明了如何使用 Sheets API 的 spreadsheets.values 资源实现一些常见的写入操作。
请注意，也可以使用 spreadsheet.batchUpdate 方法写入单元格值，如果您希望同步更新单元格格式设置或 spreadsheets.values 资源不会影响的其他属性，此方法将非常实用。例如，如果您想将一组单元格从一个工作表复制到另一个工作表，同时覆盖单元格公式和单元格格式，则可以将 UpdateCellsRequest 方法与 spreadsheet.batchUpdate 结合使用。
不过，对于简单的值写入操作，使用 spreadsheets.values.update 方法或 spreadsheets.values.batchUpdate 方法更简单。
为保证语言中立性，这些示例以 HTTP 请求的形式呈现。如需了解如何使用 Google API 客户端库以不同语言实现写入，请参阅读取和写入单元格值。
在这些示例中，占位符 SPREADSHEET_ID 表示您需要提供电子表格 ID 的位置，可以从电子表格网址中找到此 ID。要写入的范围使用 A1 表示法指定。示例范围是 Sheet1!A1:D5。
向单个范围写入数据
从一个新的空白电子表格开始，以下 spreadsheets.values.update 代码示例展示了如何将值写入到范围。ValueInputOption 查询参数是一个必要参数，并确定是否解析写入的值（例如，是否将字符串转换为日期）。
请求正文是一个 ValueRange 对象，该对象对要写入的范围值进行了说明。majorDimension 字段指示数组是否为按行组织的值列表。目标范围中的现有值会被替换。
请求协议如下所示。
PUT https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5?valueInputOption=VALUE_INPUT_OPTION{
"range": "Sheet1!A1:D5",
"majorDimension": "ROWS",
"values": [
["Item", "Cost", "Stocked", "Ship Date"],
["Wheel", "$20.50", "4", "3/1/2016"],
["Door", "$15", "2", "3/15/2016"],
["Engine", "$100", "1", "3/20/2016"],
["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"]
],
}响应包含一个 UpdateValuesResponse 对象，如下所示：
{
"spreadsheetId": SPREADSHEET_ID,
"updatedRange": "Sheet1!A1:D5",
"updatedRows": 5,
"updatedColumns": 4,
"updatedCells": 20,
}生成的工作表如下所示：
| A | B | C | D | |
| 1 | 项 | 费用 | 库存 | 发货日期 |
| 2 | 车轮 | 20.50 美元 | 4 | 2016 年 3 月 1 日 |
| 3 | 门 | $15 | 2 | 2016 年 3 月 15 日 |
| 4 | 引擎 | $100 | 1 | 2016 年 3 月 20 日 |
| 5 | 合计 | 135.5 美元 | 7 | 2016 年 3 月 20 日 |
向范围选择性写入值
在向范围写入值时，将相应的数组元素设为 null 可以避免对某些现有单元格进行更改。您也可以通过向单元格中写入空字符串 ("") 来清除其数据。
以下 spreadsheets.values.update 代码示例从一个包含上面示例生成的相同数据的工作表开始，展示了如何将值写入范围 B1:D4，同时选择性保留某些单元格不变和清除其他单元格。ValueInputOption 查询参数是一个必要参数，并确定是否解析写入的值（例如，是否将字符串转换为日期）。
请求正文是一个 ValueRange 对象，该对象对要写入的范围值进行了说明。majorDimension 字段指示数组是否为按列组织的值列表。
请求协议如下所示。
PUT https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!B1?valueInputOption=VALUE_INPUT_OPTION{
"range": "Sheet1!B1",
"majorDimension": "COLUMNS",
"values": [
[null,"$1","$2", ""],
[],
[null,"4/1/2016", "4/15/2016", ""]
]
}此处的 values 字段将列出对范围中的每一列进行的更改。第一个数组指示 B1 保持不变（由于存在 null 数组元素），而 B4 将被清除（空字符串）。B2 和 B3 的值将更新。第三个数组会在 D 列执行相同操作，而第二个空数组则指示 C 列保持不变。
响应包含一个 UpdateValuesResponse 对象，如下所示：
{
"spreadsheetId": SPREADSHEET_ID,
"updatedRange": "Sheet1!B1:D5",
"updatedRows": 3,
"updatedColumns": 2,
"updatedCells": 6,
}生成的工作表如下所示：
| A | B | C | D | |
| 1 | 项 | 费用 | 库存 | 发货日期 |
| 2 | 车轮 | $1.00 | 4 | 2016 年 4 月 1 日 |
| 3 | 门 | $2 | 2 | 2016 年 4 月 15 日 |
| 4 | 引擎 | 1 | ||
| 5 | 合计 | $3.00 | 7 | 2016 年 4 月 15 日 |
请注意，尽管“总计”行不是直接通过此请求更改，该行也会发生变化，因为其单元格包含依赖于已更改单元格的公式。
向多个范围写入数据
以下 spreadsheets.values.batchUpdate 代码示例展示了如何从一个空白工作表开始，将值写入范围 Sheet1!A1:A4 和 Sheet1!B1:D2。目标范围中的现有值会被覆盖。请求正文包含一个 ValueInputOption 对象（显示如何解读输入数据），以及一个与每个写入的范围相对应的 ValueRange 对象数组。majorDimension 字段确定是否将包含的数组解释为列或行数组。
请求协议如下所示。
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchUpdate{
"valueInputOption": "VALUE_INPUT_OPTION",
"data": [
{
"range": "Sheet1!A1:A4",
"majorDimension": "COLUMNS",
"values": [
["Item", "Wheel", "Door", "Engine"]
]
},
{
"range": "Sheet1!B1:D2",
"majorDimension": "ROWS",
"values": [
["Cost", "Stocked", "Ship Date"],
["$20.50", "4", "3/1/2016"]
]
}
]
}响应包含一个列出已更新单元格统计信息的对象和一个 UpdateValuesResponse 对象数组，每个对象对应于一个更新后的范围。例如：
{
"spreadsheetId": SPREADSHEET_ID,
"totalUpdatedRows": 4,
"totalUpdatedColumns": 4,
"totalUpdatedCells": 10,
"totalUpdatedSheets": 1,
"responses": [
{
"spreadsheetId": SPREADSHEET_ID,
"updatedRange": "Sheet1!A1:A4",
"updatedRows": 4,
"updatedColumns": 1,
"updatedCells": 4,
},
{
"spreadsheetId": SPREADSHEET_ID,
"updatedRange": "Sheet1!B1:D2",
"updatedRows": 2,
"updatedColumns": 3,
"updatedCells": 6,
}
],
}生成的工作表如下所示：
| A | B | C | D | |
| 1 | 项 | 费用 | 库存 | 发货日期 |
| 2 | 车轮 | 20.50 美元 | 4 | 2016 年 3 月 1 日 |
| 3 | 门 | |||
| 4 | 引擎 | |||
| 5 |
写入值而不解析
以下 spreadsheets.values.update 代码示例从空白工作表开始，展示了如何将值写入范围 Sheet1!A1:E1，但使用了 RAW ValueInputOption 查询参数，以防止将写入的字符串解析为公式、布尔值或数字。它们以字符串的形式显示，并且文本对齐方式在工作表中对齐。
请求正文是一个 ValueRange 对象，该对象对要写入的范围值进行了说明。majorDimension 字段表示数组是按行组织的值列表。目标范围中的现有值会被替换。
请求协议如下所示。
PUT https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:E1?valueInputOption=RAW{
"range": "Sheet1!A1:E1",
"majorDimension": "ROWS",
"values": [
["Data", 123.45, true, "=MAX(D2:D4)", "10"]
],
}响应包含一个 UpdateValuesResponse 对象，如下所示：
{
"spreadsheetId": SPREADSHEET_ID,
"updatedRange": "Sheet1!A1:E1",
"updatedRows": 1,
"updatedColumns": 5,
"updatedCells": 5,
}生成的工作表如下所示：
| A | B | C | D | E | |
| 1 | 数据 | 123.45 | TRUE | =MAX(D2:D4) | 10 |
| 2 |
请注意，“TRUE”是居中显示的布尔值，而“123.45”靠右对齐，因为它是一个数字，而“10”靠左对齐，因为它是一个字符串。公式不会被解析，并且会以字符串的形式显示。
附加值
从一个类似于下表的工作表开始：
| A | B | C | D | |
| 1 | 项 | 费用 | 库存 | 发货日期 |
| 2 | 车轮 | 20.50 美元 | 4 | 2016 年 3 月 1 日 |
| 3 |
以下 spreadsheets.values.append 代码示例展示了如何从第 3 行开始添加两行新值。ValueInputOption 查询参数是一个必要参数，并确定是否解析写入的值（例如，是否将字符串转换为日期）。
请求正文是一个 ValueRange 对象，该对象对要写入的范围值进行了说明。majorDimension 字段表示数组是按行组织的值列表。
请求协议如下所示。
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:E1:append?valueInputOption=VALUE_INPUT_OPTION{
"range": "Sheet1!A1:E1",
"majorDimension": "ROWS",
"values": [
["Door", "$15", "2", "3/15/2016"],
["Engine", "$100", "1", "3/20/2016"],
],
}响应包含一个 AppendValuesResponse 对象，如下所示：
{
"spreadsheetId": SPREADSHEET_ID,
"tableRange": "Sheet1!A1:D2",
"updates": {
"spreadsheetId": SPREADSHEET_ID,
"updatedRange": "Sheet1!A3:D4",
"updatedRows": 2,
"updatedColumns": 4,
"updatedCells": 8,
}
}生成的工作表如下所示：
| A | B | C | D | |
| 1 | 项 | 费用 | 库存 | 发货日期 |
| 2 | 车轮 | 20.50 美元 | 4 | 2016 年 3 月 1 日 |
| 3 | 门 | $15 | 2 | 2016 年 3 月 15 日 |
| 4 | 引擎 | $100 | 1 | 2016 年 3 月 20 日 |
| 5 |