第三方应用开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
第三方应用开发
服务端API
文档
管理智能表格内容
获取编组
获取编组
最后更新:2025/08/18

获取编组

本接口用于在智能表中的某个子表里获取已有的编组。

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

请求包体

{
	"docid": "DOCID",
	"sheet_id": "SHEETID",
	"offset":0,
	"limit":10
}

参数说明

参数类型是否必须说明
docidstring文档的docid
sheet_idstring表格ID
offsetuint32偏移量,初始值为 0
limituint32分页大小 , 每页返回多少条数据

权限说明

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

返回示例

{
	"errcode": 0,
	"errmsg": "ok",
	"total": 1,
	"has_more": false,
	"next": 0,
	"field_groups": [{
		"field_group_id": "FIELD_GROUP_ID",
		"name": "编组名称",
		"children": [{
			"field_id": "FIELD_ID"
		}]
	}]
}

参数说明

参数类型说明
errcodeint32错误码
errmsgstring错误码说明
totaluint32编组数量
has_morebool是否还有更多数据
nextuint32下一偏移位置
field_groupsobj[]编组列表
field_groups.field_group_idstring编组id
field_groups.namestring编组名称
field_groups.childrenobject[]编组内容
field_groups.children.field_idstring字段id
上一篇更新编组
下一篇获取文档权限信息
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
客户端API
小程序
基础
连接微信
办公
JS-SDK
基础
连接微信
办公
更新日志
联系我们