服务商代开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
服务商代开发
服务端API
文档
编辑智能表格内容
添加视图
添加视图
最后更新:2024/09/12

目录

  • 添加视图
  • 参数详细说明
  •       View
  •       ViewType
  •       GanttViewProperty
  •       CalendarViewProperty
  • 添加视图

    本接口用于在 Smartsheet 中的某个子表里添加一个新视图。单表最多允许有200个视图。

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

    请求包体

    {
    	"docid": "DOCID",
    	"sheet_id": "123Abc",
    	"view_title": "XXX",
    	"view_type": "VIEW_TYPE_GRID"
    }

    参数说明

    参数类型是否必须说明
    docidstring文档的docid
    sheet_idstringSmartsheet 子表ID
    view_titlestring视图标题
    view_typestring视图类型。见ViewType
    property_ganttobect(GanttViewProperty)甘特视图属性,添加甘特图时必填
    property_calendarobject(CalendarViewProperty)日历视图属性,添加日历视图时必填

    权限说明

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

    返回示例

    {
    	"errcode": 0,
    	"errmsg": "ok",
    	"view": {
    		"view_id": "vFYZUS",
    		"view_title": "XXX",
    		"view_type": "VIEW_TYPE_GRID"
    	}
    }

    参数说明

    参数类型说明
    errcodeint32错误码
    errmsgstring错误码说明
    viewobject(View)添加视图响应

    参数详细说明

    View

    示例

    {
    	"view_id": "vabcde",
    	"view_title": "默认视图",
    	"view_type": "VIEW_TYPE_GRID"
    }

    视图信息:

    参数名类型描述
    view_idstring视图 ID
    view_titlestring视图标题
    view_typestring视图类型。见ViewType

    ViewType

    视图类型:

    枚举类型描述
    VEW_UNKNOWN未知类型视图,传递该值不合法
    VIEW_TYPE_GRID网格视图
    VIEW_TYPE_KANBAN看板视图
    VIEW_TYPE_GALLERY画册视图
    VIEW_TYPE_GANTT甘特视图
    VIEW_TYPE_CALENDAR日历视图

    GanttViewProperty

    甘特设置

    参数名类型是否必须描述
    start_date_field_idstring时间条起点字段ID,只允许日期类型(FIELD_TYPE_DATE_TIME)的字段ID
    end_date_field_idstring时间条终点字段ID,只允许日期类型(FIELD_TYPE_DATE_TIME)的字段ID

    CalendarViewProperty

    日历设置

    参数名类型是否必须描述
    start_date_field_idstring时间条起点字段ID,只允许日期类型(FIELD_TYPE_DATE_TIME)的字段ID
    end_date_field_idstring时间条终点字段ID,只允许日期类型(FIELD_TYPE_DATE_TIME)的字段ID

     

    上一篇更新子表
    下一篇删除视图
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    客户端API
    小程序
    基础
    连接微信
    办公
    WECOM-JSSDK
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们