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