REST Resource: spreadsheets.values

资源:ValueRange

电子表格范围内的数据。

JSON 表示法
{
  "range": string,
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
字段
range

string

值涵盖的范围(采用 A1 表示法)。对于输出,此范围表示所请求的整个范围,即使这些值会排除尾随行和列也是如此。附加值时,此字段表示用于搜索表的范围,附加值将在该范围之后。

majorDimension

enum (Dimension)

值的主要维度。

对于输出,如果电子表格数据为 A1=1,B1=2,A2=3,B2=4,则请求 range=A1:B2,majorDimension=ROWS 将返回 [[1,2],[3,4]],而请求 range=A1:B2,majorDimension=COLUMNS 将返回 [[1,3],[2,4]]

对于输入,如果使用 range=A1:B2,majorDimension=ROWS,则 [[1,2],[3,4]] 会设置 A1=1,B1=2,A2=3,B2=4。如果采用 range=A1:B2,majorDimension=COLUMNS[[1,2],[3,4]] 将会设置 A1=1,B1=3,A2=2,B2=4

写入时,如果未设置此字段,则默认为 ROWS。

values[]

array (ListValue format)

已读取或要写入的数据。这是一个由数组组成的数组,外部数组代表所有数据,每个内部数组代表一个主要维度。内部数组中的每个项都对应一个单元格。

对于输出,不包括空的尾随行和列。

对于输入,支持的值类型包括:bool、string 和 double。系统会跳过 Null 值。如需将单元格设置为空值,请将字符串值设置为空字符串。

方法

append

将值附加到电子表格。

batchClear

清除电子表格中的一个或多个值范围。

batchClearByDataFilter

清除电子表格中的一个或多个值范围。

batchGet

返回电子表格中的一个或多个值范围。

batchGetByDataFilter

返回与指定数据过滤条件匹配的一个或多个值范围。

batchUpdate

设置电子表格的一个或多个范围中的值。

batchUpdateByDataFilter

设置电子表格中一个或多个范围中的值。

clear

清除电子表格中的值。

get

返回电子表格中的值范围。

update

设置电子表格范围内的值。