目录
本接口用于在 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"
}
参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| docid | string | 是 | 文档的docid |
| sheet_id | string | 是 | Smartsheet 子表ID |
| view_title | string | 是 | 视图标题 |
| view_type | string | 是 | 视图类型。见ViewType |
| property_gantt | obect(GanttViewProperty) | 否 | 甘特视图属性,添加甘特图时必填 |
| property_calendar | object(CalendarViewProperty) | 否 | 日历视图属性,添加日历视图时必填 |
权限说明
返回示例
{
"errcode": 0,
"errmsg": "ok",
"view": {
"view_id": "vFYZUS",
"view_title": "XXX",
"view_type": "VIEW_TYPE_GRID"
}
}
参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 错误码 |
| errmsg | string | 错误码说明 |
| view | object(View) | 添加视图响应 |
示例
{
"view_id": "vabcde",
"view_title": "默认视图",
"view_type": "VIEW_TYPE_GRID"
}
视图信息:
| 参数名 | 类型 | 描述 |
|---|---|---|
| view_id | string | 视图 ID |
| view_title | string | 视图标题 |
| view_type | string | 视图类型。见ViewType |
视图类型:
| 枚举类型 | 描述 |
|---|---|
| VEW_UNKNOWN | 未知类型视图,传递该值不合法 |
| VIEW_TYPE_GRID | 表格视图 |
| VIEW_TYPE_KANBAN | 看板视图 |
| VIEW_TYPE_GALLERY | 画册视图 |
| VIEW_TYPE_GANTT | 甘特视图 |
| VIEW_TYPE_CALENDAR | 日历视图 |
甘特设置
| 参数名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| start_date_field_id | string | 是 | 时间条起点字段ID,只允许日期类型(FIELD_TYPE_DATE_TIME)的字段ID |
| end_date_field_id | string | 是 | 时间条终点字段ID,只允许日期类型(FIELD_TYPE_DATE_TIME)的字段ID |
日历设置
| 参数名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| start_date_field_id | string | 是 | 时间条起点字段ID,只允许日期类型(FIELD_TYPE_DATE_TIME)的字段ID |
| end_date_field_id | string | 是 | 时间条终点字段ID,只允许日期类型(FIELD_TYPE_DATE_TIME)的字段ID |
