创建日历

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

注: 企业微信需要更新到3.0.2及以上版本

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

请求包体:

{
    "calendar" : {
        "organizer" : "userid1",
        "readonly" : 1,
        "set_as_default" : 1,
        "summary" : "test_summary",
        "color" : "#FF3030",
        "description" : "test_describe",
        "shares" : [
            {
                "userid" : "userid2"
            },
            {
                "userid" : "userid3",
                "readonly" : 1
            }
        ]
    }
}

参数说明:

参数 是否必须 说明
calendar 日历信息
organizer 指定的组织者userid。注意该字段指定后不可更新
readonly 日历组织者对日历是否只读权限(即不可编辑日历,不可在日历上添加日程,仅可作为组织者删除日历)。
0-否;1-是。默认为1,即只读
set_as_default 是否将该日历设置为组织者的默认日历。
0-否;1-是。默认为0,即不设为默认日历
summary 日历标题。1 ~ 128 字符
color 日历在终端上显示的颜色,RGB颜色编码16进制表示,例如:”#0000FF” 表示纯蓝色
description 日历描述。0 ~ 512 字符
shares 日历共享成员列表。最多2000人
shares.userid 日历共享成员的id
shares.readonly 共享成员对日历是否只读权限(即不可编辑日历,不可在日历上添加日程,仅可以退出日历)。
0-否;1-是。默认为1,即只读

返回结果:

{ 
    "errcode": 0,
    "errmsg" : "ok",
    "cal_id":"wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA"
}

参数说明:

参数 说明
errcode 错误码
errmsg 错误码说明
cal_id 日历ID
© 1998 - 2020 Tencent Inc. All Rights Reserved