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

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