读取多个范围

该接口用于根据 spreadsheetToken 和 ranges 读取表格多个范围的值，返回数据限制为10M。
目前对于含有公式的单元格，仅能获取除跨表引用、数组公式以外的公式的值。
user_id_type目前默认值为lark_id，2022年1月26日后将会调整默认值为open_id，且不再支持lark_id，请尽快适配！

错误码

具体可参考：服务端错误码说明

{ "code": 0, "data": { "revision": 0, "spreadsheetToken": "***", "totalCells": 0, "valueRanges": [ { "majorDimension": "ROWS", "range": "range1", "revision": 0, "values": [ [ "***" ] ] }, { "majorDimension": "ROWS", "range": "range2", "revision": 0, "values": [ [ "***" ] ] } ] }, "msg": "Success" }

请求参数

Path 参数

spreadsheetToken

string

必需

spreadsheet 的 token，获取方式见在线表格开发指南

Query 参数

ranges

string

必需

多个查询范围如 url?ranges=range1,range2 ，⁣其中 range 包含 sheetId 与单元格范围两部分，目前支持四种索引方式，详见在线表格开发指南

valueRenderOption

string

可选

valueRenderOption=ToString 可返回纯文本的值(数值类型除外)；valueRenderOption=FormattedValue 计算并格式化单元格；valueRenderOption=Formula单元格中含有公式时返回公式本身；valueRenderOption=UnformattedValue计算但不对单元格进行格式化

dateTimeRenderOption

string

可选

dateTimeRenderOption=FormattedString 计算并将时间日期按照其格式进行格式化，但不会对数字进行格式化，返回格式化后的字符串。详见电子表格常见问题

user_id_type

string

可选

返回的用户id类型，可选open_id,union_id

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

返回响应

🟢200成功

application/json

Body

code

integer

必需

data

object

必需

revision

integer

必需

sheet 的版本号

spreadsheetToken

string

必需

spreadsheet 的 token，详见在线表格开发指南

totalCells

integer

读取的单元格总数

必需

valueRanges

array [object {4}]

值与范围

必需

msg

string

必需

错误码#

请求参数

返回响应

错误码