REST Resource: spreadsheets.values

{
  "range": string,
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}

string

值涵盖的范围（采用 A1 表示法）。对于输出，此范围表示请求的整个范围，即使值将排除末尾的行和列也是如此。附加值时，此字段表示要搜索表的范围，系统会在此范围后附加值。

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。

array (ListValue format)

要读取或写入的数据。这是一个数组的数组，外部数组表示所有数据，每个内部数组表示一个主要维度。内部数组中的每一项对应于一个单元格。

在输出时，不包含空白的尾随行和列。

对于输入，支持的值类型包括：bool、string 和 double。系统会跳过 null 值。要将单元格设置为空值，请将字符串值设置为空字符串。