更新 Doc 文档内容

... 2022-7-14 大约 2 分钟

# 更新 Doc 文档内容

fileID

150

# 接口说明

本接口用于更新 Doc 文档内容，支持批量更新。

注意：

1、批量更新请求，若其中有一个操作报错则全部更新操作不生效。

2、单次批量更新操作数量 <= 30。

# 权限说明

本接口需要拥有以下任意一项权限：

scope.doc

# 请求

描述	定义
Path	/openapi/doc/v3/{fileId}:batchUpdate
Method	POST
Content-Type	application/json
Accept	application/json

# 请求头部

详见Headers。

# 请求参数

# 路径参数

参数名	类型	必选	描述
fileId	string	是	文档唯一标识，详见fileId

# 查询参数

无

# 请求体

参数名	类型	必选	描述
requests[]	object(Request)	是	要执行的批量更新操作,同一个请求中批量操作的 `request` 数量不能超过30个。
version	integer	否	操作的文档版本, 该参数可以通过获取 Doc 文档内容获得。要更新的文档版本与最新文档版本相差不能超过100。

# 响应

# 响应体

无

# 示例

# 请求示例

curl --location --request POST 'https://docs.qq.com/openapi/doc/v3/300000000$AAAAAAAAAAAA:batchUpdate' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' \
--header 'Open-Id: OPEN_ID' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requests": [
        {
            "insertText": {
                "text": "test",
                "location": {
                    "index": 10
                }
            }
        },
        {
            "insertTable": {
                "rows": 2,
                "cols": 2,
                "location": {
                    "index": 10
                }
            }
        }
    ],
    "version":10
}'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# 响应示例

{}

# 错误码

HTTP 状态码	业务错误码	描述	排查建议
400	400001	请求参数错误	确认传入的参数是否合法
429	400007	请求数超过限制	请求数超过限频，请降低调用频率
500	400010	服务内部错误	服务端错误，请联系开发者

查询更多业务返回码

获取 Doc 文档内容接口索引