本文档由石墨办公提供。

追加表格内容

PUT

/sdk/v2/api/files/{fileId}/sheets/values

根据传入的表格范围追加表格内容（只支持纯文本和数字）。

支持文件类型：

spreadsheet 表格

根据 range 查找追加位置的逻辑是定位到需要追加的行位置：

不指定单元格范围，例如range = "工作表 1"：会遍历整个表格，找到最后一个有数据的行

指定单元格范围，例如range = 工作表 1!C5:E8：会找到起始单元格 C5 所在的行，从该行向下遍历，找到最后一个连续的有数据行向下插入 N 行，填充 values，其中 N = values.length

如果修改了不存在的列，会自动新增到该列。

请求参数

Path 参数

Header 参数

Body 参数application/json

示例

{
    "range": "工作表1!A1:C3",
    "resource": {
        "values": [
            ["第一行第一列追加文本","第一行第二列追加文本"],
            ["第二行第一列追加文本","第二行第二列追加文本"]
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT '/sdk/v2/api/files/8bff2c66dfc6ef0b/sheets/values' \
--header 'X-Shimo-Signature: {{signature}}' \
--header 'X-Shimo-Token: {{token}}' \
--header 'Content-Type: application/json' \
--data '{
    "range": "工作表1!A1:C3",
    "resource": {
        "values": [
            ["第一行第一列追加文本","第一行第二列追加文本"],
            ["第二行第一列追加文本","第二行第二列追加文本"]
        ]
    }
}'

返回响应

🟢204成功

该响应没有 Body

修改于 2026-08-31 07:51:39

更新表格内容

删除表格行