日程接口更新日程 - 企业微信 API

该接口用于在日历中更新指定的日程。

注意，更新操作是覆盖式，而不是增量式
不可更新组织者和日程所属日历ID

关于自定义重复的说明：
is_custom_repeat 如果为0，那么系统会根据 start_time 和 repeat_type 来自动计算下一次重复的时间，例如：

start_time 为本周周三8点整，repeat_type 为每周重复，那么每周三8点整重复；
start_time 为本月3号10点整，repeat_type 为每月重复，那么每月3号10点整重复；

如果 is_custom_repeat 指定为1，那么可以配合 repeat_day_of_week 或 repeat_day_of_month 特别指定周几或几号重复，且可以使用 repeat_interval 指定重复间隔

文档ID: 26903
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93648
https://open.work.weixin.qq.com/api/doc/90001/90143/93703

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/oa/schedule/update?access_token=' \ --header 'Content-Type: application/json' \ --data-raw '{ "skip_attendees ": 0, "op_mode": 1, "op_start_time": 1571274600, "schedule": { "admins":[ "admin1", "admin2" ], "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, "repeat_until": 1606976813, "is_custom_repeat": 1, "repeat_interval": 1, "repeat_day_of_week": [3, 7], "repeat_day_of_month": [10, 21], "timezone": 8 }, "location": "test_place", } }'

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

skip_attendees

integer

可选

是否不更新参与人。0-否；1-是。默认为0

op_mode

integer

可选

操作模式。是重复日程时有效。 0-默认全部修改； 1-仅修改此日程； 2-修改将来的所有日程详见重复日程的不同操作模式

op_start_time

integer

可选

操作起始时间。仅当操作模式是1或2时有效。该时间必须是重复日程的某一次开始时间例如：假如日程开始时间start_time为1661990950（2022-09-01 08:09:10），且重复类型是每周，那么op_start_time可以是：1661990950（2022-09-01 08:09:10）、1662595750（2022-09-08 08:09:10）、1663200550（2022-09-15 08:09:10）......

schedule

object

日程信息

必需

admins

array[string]

必需

schedule_id

string

必需

日程ID。创建日程时返回的ID

start_time

integer

必需

日程开始时间，Unix时间戳注意，如果op_mode是1或2，start_time和end_time，必须是op_start_time当天或之后的时间

end_time

integer

必需

日程结束时间，Unix时间戳

attendees

array [object {1}]

可选

日程参与者列表。最多支持2000人

summary

string

可选

日程标题。0 ~ 128 字符。不填会默认显示为“新建事件”

description

string

可选

日程描述不多于512个字符

reminders

object

提醒相关信息

可选

location

string

可选

日程地址不多于128个字符

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

错误码描述

必需

schedule_id

string

必需

修改重复日程新产生的日程ID。对于重复日程，如果不是修改全部周期，会修剪原重复日程，产生新的重复日程，此时会返回新日程的ID