第三方应用开发 服务端API 日程 管理日历 创建日历
创建日历
最后更新:2023/04/23
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
创建日历
最后更新:2023/04/23

该接口用于通过应用在企业内创建一个日历。

请求方式: POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/oa/calendar/add?access_token=ACCESS_TOKEN

请求包体:

{
	"calendar": {
		"admins":[
				"admin1",
				"admin2"
		],
		"set_as_default": 1,
		"summary": "test_summary",
		"color": "#FF3030",
		"description": "test_describe",
		"shares": [{
				"userid": "userid2",
				"permission": 1
			},
			{
				"userid": "userid3",
				"permission": 3
			}
		],
		"is_public": 1,
		"public_range": {
			"userids": ["abel", "jack"],
			"partyids": [1232, 34353]
		},
		"is_corp_calendar": 1
	},
	"agentid": 1000014
}

参数说明:

参数是否必须说明
calendar日历信息
admins日历的管理员userid列表,管理员必须在通知范围成员的列表中。最多指定3人
set_as_default是否将该日历设置为access_token所对应应用的默认日历。
0-否;1-是。默认为0,即不设为默认日历
第三方应用不支持使用该参数
summary日历标题。1 ~ 128 字符
color日历在终端上显示的颜色,RGB颜色编码16进制表示,例如:"#0000FF" 表示纯蓝色
description日历描述。0 ~ 512 字符
is_public是否公共日历。0-否;1-是。注意:每个人最多可创建或订阅100个公共日历。该属性不可更新
public_range公开范围。仅当是公共日历时有效
public_range.userids公开的成员列表范围 。最多指定1000个成员
public_range.partyids公开的部门列表范围 。最多指定100个部门
is_corp_calendar是否全员日历。0-否;1-是。注意:
1. 每个企业最多可创建20个全员日历
2. 全员日历也是公共日历的一种,需要指定public_range
3. 全员日历不支持指定颜色、默认日历、只读权限
4. 该属性不可更新
shares日历通知范围成员列表。最多2000人
shares.userid日历通知范围成员的id
shares.permission日历通知范围成员权限(不填则默认为「可查看」)。
1:可查看
3:仅查看闲忙状态
agentid授权方安装的应用agentid。仅旧的第三方多应用套件需要填此参数

 

返回结果:

{ 
	"errcode": 0,
	"errmsg" : "ok",
	"cal_id":"wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA",
	"fail_result": {
		"shares":[{
			"errcode": 40001,
			"errmsg": "not found",
			"userid": "userid3"
		}]
	}
}

参数说明:

参数说明
errcode错误码
errmsg错误码说明
cal_id日历ID
fail_result无效的输入内容
fail_result.shares无效的日历通知范围成员列表
shares.errcode错误码
shares.errmsg错误码说明
shares.userid日历通知范围成员的id
上一篇
概述
下一篇
更新日历