Method: spreadsheets.values.append

将值附加到电子表格。输入范围用于搜索现有数据和查找“表格”该范围内的用户值将附加到表格的下一行，从表格的第一列开始。如需详细了解如何检测表以及如何附加数据，请参阅指南和示例代码。

调用方必须指定电子表格 ID、范围和 valueInputOption。valueInputOption 仅控制将输入数据添加到工作表的方式（按列或按行添加），而不会影响开始将数据写入哪个单元格。

HTTP 请求

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

网址采用 gRPC 转码语法。

路径参数

参数
spreadsheetId

string

要更新的电子表格的 ID。
range

string

范围的 A1 表示法，用于搜索数据逻辑表。值会附加在表的最后一行之后。

查询参数

参数
valueInputOption

enum (ValueInputOption)

应如何解读输入数据。
insertDataOption

enum (InsertDataOption)

应如何插入输入数据。
includeValuesInResponse

boolean

确定更新响应是否应包含所附加单元格的值。默认情况下，响应不包含更新后的值。
responseValueRenderOption

enum (ValueRenderOption)

确定响应中的值应如何呈现。默认渲染选项为 FORMATTED_VALUE。
responseDateTimeRenderOption

enum (DateTimeRenderOption)

确定在响应中呈现日期、时间和时长的方式。如果 responseValueRenderOption 为 FORMATTED_VALUE，系统会忽略此属性。默认的 dateTime 呈现选项为 SERIAL_NUMBER。

请求正文

请求正文包含一个 ValueRange 实例。

响应正文

更新电子表格中的一系列值时的响应。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "spreadsheetId": string,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
字段
spreadsheetId

string

应用更新所应用到的电子表格。
tableRange

string

要附加值（在附加值之前）的表格的范围（采用 A1 表示法）。如果未找到任何表，则为空。
updates

object (UpdateValuesResponse)

已应用的更新的相关信息。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

有关详情，请参阅授权指南。

InsertDataOption

确定在输入新数据时如何更改现有数据。

枚举
OVERWRITE 新数据将覆盖其写入区域中的现有数据。（注意：如果在工作表末尾添加数据，系统仍会插入新的行或列，以便写入数据。）
INSERT_ROWS 然后，为新数据插入相应的行。