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

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