应用平台 APPSTAGE-企业微信:更新日程
更新日程
该接口用于在日历中更新指定的日程。
- 输入参数
输入参数说明如表17所示。
表17 更新日程输入参数说明 参数
必填
说明
调用接口凭证
是
调用接口凭证。
organizer
否
组织者不多于64字节。
schedule_id
是
日程ID。创建日程时返回的ID。
start_time
否
日程开始时间,Unix时间戳。
end_time
否
日程结束时间,Unix时间戳。
summary
否
日程标题,0~128 字符。不填会默认显示为“新建事件”。
description
否
日程描述不多于512个字符。
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:工作日
repeat_until
否
重复结束时刻,Unix时间戳。不填或填0表示一直重复。
is_custom_repeat
否
是否自定义重复。
0:否
1:是
repeat_interval
否
重复间隔仅当指定为自定义重复时有效该字段随repeat_type不同而含义不同,例如:
- repeat_interval指定为3,repeat_type指定为每周重复,那么每3周重复一次repeat_interval指定为3,repeat_type指定为每月重复,那么每3个月重复一次
timezone
否
时区。UTC偏移量表示(即偏离零时区的小时数),东区为正数,西区为负数。例如:+8 表示北京时间东八区默认为北京时间东八区。
取值范围:-12~+12
location
否
日程地址,不多于128个字符。
skip_attendees
否
忽略掉attendees参数,只更新其他参数,默认值是false。
attendees
否
日程参与者列表。最多支持2000人。
repeat_day_of_week
否
每周周几重复仅当指定为自定义重复且重复类型为每周时有效取值范围:1~7,分别表示周一至周日。
repeat_day_of_month
否
每月哪几天重复仅当指定为自定义重复且重复类型为每月时有效取值范围:1~31,分别表示1~31号。
- 输出参数
用户可以在之后的执行动作中调用该输出参数,输出参数说明请参见表18。