获取文件的历史列表

获取文件侧边栏历史列表信息，历史类型分为操作历史和编辑历史。

操作历史说明 (historyType = 1)

表示手动操作而通常不造成文件内容等发生变化的记录，例如创建版本、锁定单元格等操作，此类历史的类型及上下文信息存于 content 字段中，格式为 JSON 字符串形式。

JSON 数据为 histories[i].content 字段，经过 JSON.parse()解析后的结果如下：

createRevision 创建版本

{
  "action": "createRevision"
}

renameRevision 重命名版本

{
  "action": "renameRevision",
  "before": "修改前的版本名称",
  "after": "修改后的版本名称"
}

deleteRevision 删除版本

{
  "action": "deleteRevision",
  "label": "被删除的版本名称"
}

lock_cell 锁定单元格

{
  "action": "lock_cell",
  "range": "E14:E14",
  "name": "工作表1"
}

unlock_cell 解锁单元格

{
  "action": "unlock_cell",
  "range": ["E14:E14"],
  "name": "工作表1"
}

lock_sheet 锁定工作表

{
  "action": "lock_sheet",
  "name": "工作表1"
}

unlock_sheet 解锁工作表

{
  "action": "unlock_sheet",
  "name": "工作表1"
}

update_lock_cell 更新单元格锁定

{
  "action": "update_lock_cell",
  "range": ["E17:E17"],
  "name": "工作表1"
}

编辑历史说明 (historyType = 2)

表示一个或多个用户在一段时间内对文件内容进行了编辑。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "histories": [
        {
            "content": "{\"range\":[1,1],\"changeset\":\"[[10, \\\"\\\\n\\\", \\\"line:\\\\\\\"init\\\\\\\"\\\"]]\",\"frozen\":true}",
            "createdAt": "2021-06-07T06:12:24Z",
            "historyType": 2,
            "id": "60bdb8c847a7850006bf12c1",
            "name": "",
            "updatedAt": "2021-06-07T06:12:24Z",
            "userId": "user123,user134"
        },
        {
            "content": "{\"range\":[2,3],\"changeset\":\"省略若干内容 ...\"}",
            "createdAt": "2021-06-07T06:12:39Z",
            "historyType": 2,
            "id": "60bdb8d747a7850006bf12c2",
            "name": "",
            "updatedAt": "2021-06-07T06:12:39Z",
            "userId": "user123,user134"
        },
        {
            "content": "{\"action\":\"unlock_cell\",\"range\":[\"E14:E14\"],\"name\":\"工作表1\"}",
            "createdAt": "2022-03-11T03:58:59Z",
            "historyType": 1,
            "id": "622ac9034079aa0006d54f3b",
            "name": "",
            "updatedAt": "2022-03-11T03:58:59Z",
            "userId": "user123"
        },
        {
            "content": "{\"action\":\"lock_sheet\",\"name\":\"工作表1\"}",
            "createdAt": "2022-03-11T03:59:04Z",
            "historyType": 1,
            "id": "622ac9084079aa0006d54f3c",
            "name": "",
            "updatedAt": "2022-03-11T03:59:04Z",
            "userId": "user123"
        }
    ],
    "isLastPage": true,
    "limit": null,
    "users": {
        "user123": "testuser",
        "user134": "testuser2"
    }
}

操作历史说明 (historyType = 1)#

createRevision 创建版本#

renameRevision 重命名版本#

deleteRevision 删除版本#

lock_cell 锁定单元格#

unlock_cell 解锁单元格#

lock_sheet 锁定工作表#

unlock_sheet 解锁工作表#

update_lock_cell 更新单元格锁定#

编辑历史说明 (historyType = 2)#

请求参数