Method: spreadsheets.values.append

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

调用方必须指定电子表格 ID、范围和 valueInputOptionvalueInputOption 只能控制将输入数据添加到工作表的方式(按列或按行),而不会影响将数据写入哪个单元格。

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)

确定应如何呈现响应中的日期、时间和时长。如果 responseValueRenderOptionFORMATTED_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 新数据会插入行。