修改日程/待办
用于通过开发者接口修改日程/待办。
请求说明
| 请求地址 | 配置域名+/o/rili/g-api/v1/intranet/event/ |
|---|---|
| 请求方法 | PUT |
| 签名方式 | wps-4 |
| 支持应用类型 | 企业自建应用、第三方企业应用 |
| 权限要求 | 更新日程信息(kso.calendar.event.write) |
请求头
| 名称 | 是否必填 | 说明 |
|---|---|---|
| Content-Type | 是 | 固定为: application/json |
| Wps-Docs-Date | 是 | 取当前时间, 示例: Wed, 23 Jan 2013 06:43:08 GMT |
| Wps-Docs-Authorization | 是 | 计算方法参考签名说明 |
| Authorization | 是 | access_token(企业授权获取的token) |
请求地址示例
http
[PUT] 配置域名+/o/rili/g-api/v1/intranet/event/{taskid}请求体(Body)
| 参数 | 路径 | 类型 | 必选(Y/N) | 描述 |
|---|---|---|---|---|
| taskId | path param | long | Y | 日程/待办id |
| srcTeamId | request body | long | Y | 日历所属teamId.日程接口返回值中的team.id |
| companyId | request body | long | Y | 日程所在日历的归属人的企业id,只有当日历的拥有者在企业companyId内时才允许删除日程 |
| summary | request body | string | N | 标题,最长200个字符 |
| description | request body | string | N | 详情,最长2000个字符 |
| startTime | request body | long | N | 开始时间,单位毫秒。日程类型开始和结束时间都传;待办类型开始和结束时间可都传或都不传,传0删除 |
| endTime | request body | long | N | 日程类型开始和结束时间都传;待办类型开始和结束时间可都传或都不传,传0删除仅待办 |
| actionType | request body | int | N | 1:非全天 2:全天;仅支持新待办 (待办:eventType=8) |
| reminders | request body | json | N | 提醒规则 |
| recurrence | request body | json | N | 重复规则,freq==""和interval==0则删除,仅支持日程 |
| richText | request body | string | N | 富文本,最长50000个字符,仅支持待办 |
| teamId | request body | long | N | 修改所属群组,仅支持日程 |
| modType | request body | int | N | 默认0;0:普通日程/待办,1:重复日程单条,2:重复日程后续,3:重复日程全部 |
| whichDayTime | request body | long | N | modType为1和2时必传,表示修改重复日程的哪天,单位毫秒 |
| isNotify | request body | bool | N | 是否通知参与者, 开发者接口中默认值为false |
| autoBookingMeeting | request body | boolean | N | 是否设置为会议日程,不传或者相同值则忽略当前当前参数 |
| attachments | request body | []json | N | 最多添加20个附件(包括已有的),文档日程待办不支持修改。event_type==2文档待办,要求附件参数带link(小程序跳转地址),linkPc(web端跳转地址,约定为lc链接),wpsFileId(待办来自的文档的fileId),参数内容参考新增接口,不传为不修改,传的话,要把所有的附件都传递上来,由日程接口判断新增或减少 |
| location | request body | object | N | 见下方location对象定义 |
| idleStatus | request body | long | N | 忙闲状态,1:忙,2:闲 |
| publicStatus | request body | long | N | 公开状态,1:默认,2:公开,3:不公开 |
location定义
"location":{
"name":"珠海金山软件园", // 地址名称,必填
"address":"珠海唐家湾镇前岛环路n号", // 地址详细位置,非必填
"longitude": 120.0, // 经度,非必填
"latitude": 23.0 // 纬度,非必填
}返回值
同新建日程/待办接口