Method: spreadsheets.values.update

设置电子表格某个范围中的值。调用方必须指定电子表格 ID、范围和 valueInputOption。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
spreadsheetId

string

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

string

要更新的值的 A1 表示法。

查询参数

参数
valueInputOption

enum (ValueInputOption)

应如何解读输入数据。
includeValuesInResponse

boolean

确定更新响应是否应包含已更新单元格的值。默认情况下，响应不包含更新后的值。如果要写入的范围大于实际写入的范围，则响应会包含所请求范围中的所有值（不包括尾随的空行和列）。
responseValueRenderOption

enum (ValueRenderOption)

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

enum (DateTimeRenderOption)

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

请求正文

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

响应正文

如果成功，则响应正文包含一个 UpdateValuesResponse 实例。

授权范围

需要以下 OAuth 范围之一：

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

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