Question

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
}'

响应示例

{}

错误码

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

查询更多业务返回码