读取单个范围

GET

/sheets/v2/spreadsheets/{spreadsheetToken}/values/{range}

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

错误码

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

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET '/sheets/v2/spreadsheets//values/' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "code": 0,
    "data": {
        "revision": 0,
        "spreadsheetToken": "***",
        "valueRange": {
            "majorDimension": "ROWS",
            "range": "***",
            "revision": 0,
            "values": [
                [
                    "***"
                ]
            ]
        }
    },
    "msg": "Success"
}

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

插入数据

读取多个范围

读取单个范围

错误码#

请求参数

返回响应

错误码