编辑群组日程

接口说明

请求URL：http[s]://{网关地址}/casp-cal/updateGroupCal

请求方式： POST

请求内容类型： application/json

响应内容类型： application/json

请求说明

请求头

字段名	参数名	必填	类型	描述
应用ID	appId	M	String(128)	接入网关的应用ID
Token	accessToken	M	String	接入网关的accessToken

请求体

字段名	参数名	必填	类型
日程列表接口返回的eventId	eventId	M	String(64)
日程标题	eventTitle	M	String(100)
是否是全天日程 1：是 0：否	isAllDay	M	int
单个日程开始时间 isAllDay 为0是 格式yyyy-MM-dd HH:mm:ss 1:yyyy-MM-dd	startTime	M	String(20)
单个日程结束时间（格式同上）	endTime	M	String(20)
日程地址	eventAddr	O	String(100)
日程描述	eventDesc	O	String(1000)
链接地址	linkUrl	O	String(1024)
日程重复类型 0不重复 1每天 2每周 3每月第N天 4每年 5(按月-周重复) 第n周的n个星期几	eventRepeatType	M	int
重复间隔(重复类型时这个必填)	eventRepeatData	O	int
日程开始前多久提醒（json数组）单位分钟 全天日程的提醒时间 （-540，当天9点），（900，一天前9点），（2340， 2天前9点），（9540，一周前9点） 非全天日程的提醒时间（0，开始时），（5，5分钟前），（15，15分钟前），（30，30分钟前），（60，1小时前）, (1440, 一天前)	remindTimes	O	List<long>
用户工号	userAccount	M	String(20)
提醒通道当提醒时间不为空时，这个必填,多个用,分割 INBOX 收件箱 CAMPUSHOY 今日校园 EMAIL 邮箱 SMS 短信 QYWECHAT 企业微信 DINGTALK 钉钉 WeChatService 微信服务号 WELINK 华为weilink	remindChannel	O	String(64)
日程截止时间 格式:yyyy-MM-dd（只有重复类型 且 rangeType 是 endDate）	deadline	O	String(10)
英文小写单词指定星期几，如果有多个值逗号分割。eventRepeatType 为3时使用,可以传多个；eventRepeatType 为5时使用,只能传1个	dayOfWeek	O	String
当重复类型是5，用于指定每月第几周（first second third fourth last ） eventRepeatType 为5时使用	weekIndex	O	String(1)
循环范围类型： noEnd：永不结束 endDate：循环至指定日期结束 numbered：循环指定次数后结束	rangeType	O	String(8)
循环次数(rangTye 是numbered )	rangeNum	O	int
群组参与人工号	attendUserAccount	M	List<String>
编辑类型 0 从当前时间开始以后全部 （普通日程和重复日程使用） 当用于编辑重复日程时，会将原始日程的截止时间变为当前日程的时间，并创建一条新的 1仅当条日程（重复日程使用）	modifyType	M	int
创建人是否参与此日程3.6.2.SP8+ 1：参与 0 不参与（默认1）	isParticipant	O	int

请求示例

普通不重复

{
  "eventId":"1014998851132977152_1662307200000",

  "eventTitle": "api接口创建群组-每周1-修改当天",
  "startTime": "2022-08-31 00:00:00",
  "endTime": "2022-08-31 00:00:00",
  "eventAddr": "12323",
  "eventDesc": "描述",
  "linkUrl": "http://www.baidu.com",
  "eventRepeatType": 1,
  "eventRepeatData": 1,
  "remindTimes": [
    15
  ],

  "userAccount": "ampadmin",
  "remindChannel": "INBOX,CAMPUSHOY",
  "isAllDay": 0,
  "attendWids":["910532037738631168"],
  "attendUserAccount":["xiaoming","xiaohong"],
  "modifyType":1

}

响应说明

响应体

字段名	参数名	必填	类型	描述
返回码	errcode	M	String	0 成功，其他为不成功
返回码描述	errmsg	O	String	返回码描述

响应示例

{
  "errcode": "0",
  "errmsg": "success"
}

错误码

错误码	描述
999	统一错误码，详细描述信息参见接口返回

Demo

java

 // 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID,APP_SECRET);

// 创建请求对象
UpdateGroupCalRequest request = new UpdateGroupCalRequest();
request.setEventId("1268527206833704960");
request.setModifyType(0);
request.setAttendUserAccount(Arrays.asList("01119092"));
request.setEventTitle("8月1日群组日程tes修改名称");
request.setStartTime("2024-08-01 09:00:00");
request.setEndTime("2024-08-01 11:00:00");
request.setEventAddr("12323");
request.setEventDesc("测试群组日程");
request.setLinkUrl("http://www.baidu.com");
request.setEventRepeatType(EventRepeatType.EVENT_REPEAT_TYPE_0);
request.setEventRepeatData(1);
request.setRemindTimes(Arrays.asList(Long.valueOf("15")));
request.setUserAccount("ampadmin");
request.setRemindChannel(EventRemindChannel.INBOX);
request.setIsAllDay(0);
BaseResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
//.....
}