登录
基础
连接微信
办公
企业内部开发 服务端API 日程 管理日历 更新日历
更新日历
最后更新：2023/08/31
该接口用于修改指定日历的信息。
注意，更新操作是覆盖式，而不是增量式
请求方式： POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/oa/calendar/update?access_token=ACCESS_TOKEN
请求包体：
{
"skip_public_range" : 0,
"calendar": {
"cal_id": "wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA",
"admins":[
"admin1",
"admin2"
],
"summary": "test_summary",
"color": "#FF3030",
"description": "test_describe_1",
"shares": [{
"userid": "userid1",
"permission": 1
},
{
"userid": "userid2",
"permission": 3
}
],
"public_range": {
"userids": ["abel", "jack"],
"partyids": [1232, 34353]
}
}
}参数说明：
| 参数 | 是否必须 | 说明 |
|---|---|---|
| skip_public_range | 否 | 是否不更新可订阅范围。0-否；1-是。默认会为0，会更新可订阅范围 |
| calendar | 是 | 日历信息 |
| cal_id | 是 | 日历ID |
| admins | 否 | 日历的管理员userid列表。最多指定3人 |
| summary | 是 | 日历标题。1 ~ 128 字符 |
| color | 是 | 日历颜色，RGB颜色编码16进制表示，例如："#0000FF" 表示纯蓝色 |
| description | 否 | 日历描述。0 ~ 512 字符 |
| public_range | 否 | 公开范围。仅当是公共日历时有效 |
| public_range.userids | 否 | 公开的成员列表范围 。最多指定1000个成员 |
| public_range.partyids | 否 | 公开的部门列表范围 。最多指定100个部门 |
| shares | 否 | 日历通知范围成员列表。最多2000人 |
| shares.userid | 是 | 日历通知范围成员的id |
| shares.permission | 否 | 日历通知范围成员权限（不填则默认为「可查看」）。 1：可查看 3：仅查看闲忙状态 |
返回结果：
{
"errcode": 0,
"errmsg" : "ok",
"fail_result": {
"shares":[{
"errcode": 40001,
"errmsg": "not found",
"userid": "userid3"
}]
}
}参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 错误码 |
| errmsg | 错误码说明 |
| fail_result | 无效的输入内容 |
| fail_result.shares | 无效的日历通知范围成员列表 |
| shares.errcode | 错误码 |
| shares.errmsg | 错误码说明 |
| shares.userid | 日历通知范围成员的id |
- 更新日历
本节内容
