该接口用于在日历中更新指定的日程。
注意,更新操作是覆盖式,而不是增量式
不可更新组织者和日程所属日历ID
请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/oa/schedule/update?access_token=ACCESS_TOKEN
请求包体:
{
"schedule": {
"organizer": "userid1",
"schedule_id": "17c7d2bd9f20d652840f72f59e796AAA",
"start_time": 1571274600,
"end_time": 1571320210,
"attendees": [
{
"userid": "userid2"
}
],
"summary": "test_summary",
"description": "test_description",
"reminders": {
"is_remind": 1,
"remind_before_event_secs": 3600,
"is_repeat": 1,
"repeat_type": 7
},
"location": "test_place"
}
}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
schedule | 是 | 日程信息 |
organizer | 是 | 组织者。注意,暂不支持变更组织者 |
schedule_id | 是 | 日程ID |
start_time | 是 | 日程开始时间,Unix时间戳 |
end_time | 是 | 日程结束时间,Unix时间戳 |
attendees | 否 | 日程参与者列表。最多支持2000人 |
userid | 是 | 日程参与者ID |
summary | 否 | 日程标题。0 ~ 128 字符。不填会默认显示为“新建事件” |
description | 否 | 日程描述。0 ~ 512 字符 |
reminders | 否 | 提醒相关信息 |
is_remind | 否 | 是否需要提醒。0-否;1-是 |
remind_before_event_secs | 否 | 日程开始(start_time)前多少秒提醒,当is_remind为1时有效。例如: 300表示日程开始前5分钟提醒。目前仅支持以下数值:0 - 事件开始时300 - 事件开始前5分钟900 - 事件开始前15分钟3600 - 事件开始前1小时86400 - 事件开始前1天 |
is_repeat | 否 | 是否重复日程。0-否;1-是 |
repeat_type | 否 | 重复类型,当is_repeat为1时有效。目前支持如下类型: 0 - 每日1 - 每周2 - 每月5 - 每年7 - 工作日 |
location | 否 | 日程地址。0 ~ 128 字符 |
返回结果:
{
"errcode": 0,
"errmsg" : "ok"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 错误码 |
errmsg | 错误码说明 |