服务商代开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
服务商代开发
服务端API
文档
管理智能文档内容
更新内容块
更新内容块
最后更新:2026/07/01

用于批量更新指定页面中已有的 Block。

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartdoc/update_blocks?access_token=ACCESS_TOKEN

请求包体

{
    "docid": "DOC_ID",
    "page_id": "PAGE_ID",
    "blocks": [
        {
            "id": "BLOCK_ID",
            "type": "BLOCK_TYPE_TEXT",
            "content": "Updated Content",
            "props": {}
        }
    ]
}


请求参数说明

参数类型是否必须说明
docidstring智能文档的文档 id
page_idstring页面的id
blocksobject[](BlockInfo)需要更新的 Block 列表
blocks[].idstring需要更新的 Block ID
blocks[].typestringBlock 类型,参见 BlockType
blocks[].titlestringBlock 的文本内容
blocks[].parent_idstring父节点 Block ID
blocks[].after_idstring插入位置,表示排在哪个 Block 之后,为空表示插入到最前
blocks[].childrenstring[]子节点 ID 列表
blocks[].propsBlockPropsBlock 属性

权限说明

  • 自建应用需配置到"可调用应用"列表中的应用secret所获取的accesstoken来调用
  • 第三方应用需具有"文档"权限
  • 代开发自建应用需具有"文档"权限

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "blocks": [
        {
            "id": "BLOCK_ID",
            "type": "BLOCK_TYPE_TEXT",
            "title": "Updated Content",
            "parent_id": "PARENT_BLOCK_ID",
            "children": [],
            "props": {}
        }
    ]
}


返回参数说明

参数类型说明
errcodeint32错误码
errmsgstring错误码说明
blocksobject[](BlockInfo)更新成功后返回的 Block 列表
上一篇添加内容块
下一篇删除内容块
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
客户端API
小程序
基础
连接微信
办公
JS-SDK
基础
连接微信
办公
更新日志
联系我们