读取多个范围

GET

/sheets/v2/spreadsheets/{spreadsheetToken}/values_batch_get

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

错误码

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

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Query 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET '/sheets/v2/spreadsheets//values_batch_get?ranges&valueRenderOption&dateTimeRenderOption&user_id_type' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "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"
}

修改于 2025-10-21 06:07:47

读取单个范围

向单个范围写入数据

读取多个范围

错误码#

请求参数

返回响应

错误码