服务商代开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
服务商代开发
服务端API
文档
管理智能表格内容
添加编组
添加编组
最后更新:2025/08/20

添加编组

本接口用于在智能表中的某个子表里添加编组。单表最多允许有150个编组。每个编组最多允许有150个字段。字段只能同时存在于一个编组。

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

请求包体

{
	"docid": "DOCID",
	"sheet_id": "SHEETID",
	"name":"编组名称",
	"children": [
		{
			"field_id": "field_id"
		},
		{
			"field_id": "field_id"
		}]
}

参数说明

参数类型是否必须说明
docidstring文档的docid
sheet_idstring表格ID
namestring编组名称,不能和已有名称重复
childrenobject[]编组内容
children.field_idstring字段id

权限说明

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

返回示例

{
	"errcode": 0,
	"errmsg": "ok",
	"field_group": {
		"field_group_id": "FIELD_GROUP_ID",
		"name": "编组名称",
		"children": [{
				"field_id": "FIELD_ID"
			},
			{
				"field_id": "FIELD_ID"
			}
		]
	}
}

参数说明

参数类型说明
errcodeint32错误码
errmsgstring错误码说明
field_groupobject编组
field_group.field_group_idstring编组id
field_group.namestring编组名称
field_group.childrenobject[]编组内容
field_group.children.field_idstring字段id
上一篇查询记录
下一篇删除编组
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
客户端API
小程序
基础
连接微信
办公
JS-SDK
基础
连接微信
办公
更新日志
联系我们