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 系统会为新数据插入行。