The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
QQ-weixin-work-v0.10
River stage zero No dependents
1 ++
/ QQ::weixin::work::oa::meetingroom

Name

QQ::weixin::work::oa::meetingroom

DESCRIPTION

会议室

FUNCTION

会议室管理

最后更新：2023/11/30

权限说明

调用会议室相关接口的应用有如下的权限要求：

        应用类型    权限要求
        自建应用    配置到「应用管理 - 会议室 - 可调用接口的应用」中
        代开发应用   暂不支持
        第三方应用   暂不支持

注： 从2023年12月1日0点起，不再支持通过系统应用secret调用接口，存量企业暂不受影响 查看详情

add(access_token, hash);

添加会议室

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/93619#添加会议室

请求说明：

企业可通过此接口添加一个会议室。

请求包结构体为：

        {
          "name":"18F-会议室",
          "capacity":10,
          "city":"深圳",
          "building":"腾讯大厦",
          "floor":"18F",
          "equipment":[1,2,3],
          "coordinate":
          {
                "latitude":"22.540503",
                "longitude":"113.934528"
          },
          "range":
          {
                                "user_list":["zhangsan","lisi"],
                                "department_list":[1]
          }
        }

参数说明：

        参数              必须              说明
        access_token    是       调用接口凭证
        name    是       会议室名称，最多30个字符
        capacity        是       会议室所能容纳的人数
        city    否       会议室所在城市
        building        否       会议室所在楼宇
        floor   否       会议室所在楼层
        equipment       否       会议室支持的设备列表,参数详细含义见附录
        coordinate.latitude     否       会议室所在建筑纬度,可通过腾讯地图坐标拾取器获取
        coordinate.longitude    否       会议室所在建筑经度,可通过腾讯地图坐标拾取器获取
        range.user_list 否       会议室使用范围的userid列表，最多指定1000个成员
        range.department_list   否       会议室使用范围的部门id列表，最多指定1000个部门

如果不填写range参数，则默认为全公司可用。 如果需要为会议室设置位置信息，则必须同时填写城市（city），楼宇（building）和楼层(floor)三个参数。

权限说明

RETURN 返回结果

    {
           "errcode": 0,
           "errmsg": "ok",
           "meetingroom_id":1
        }

RETURN 参数说明

        参数          说明
    errcode     返回码
    errmsg      对返回码的文本描述内容
    meetingroom_id      会议室的id

list(access_token, hash);

查询会议室

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/93619#查询会议室

请求说明：

企业可通过此接口查询满足条件的会议室。

请求包结构体为：

    {
          "city":"深圳",
          "building":"腾讯大厦",
          "floor":"18F",
          "equipment":[1,2,3]
        }

参数说明：

        参数              是否必须            说明
        access_token    是       调用接口凭证
        city    否       会议室所在城市
        building        否       会议室所在楼宇
        floor   否       会议室所在楼层
        equipment       否       会议室支持的设备列表,参数详细含义见附录

如果需要使用某个位置信息进行查询，则需要保证其上一级的位置信息已填写，即如需使用楼宇进行过滤，则必须同时填写城市字段

权限说明

RETURN 返回结果

         {
           "errcode": 0,
           "errmsg": "ok",
           "meetingroom_list":
           [
           {
                "meetingroom_id":1,
                "name":"18F-会议室",
                "capacity":10,
                "city":"深圳",
                "building":"腾讯大厦",
                "floor":"18F",
                "equipment":[1,2,3],
                "coordinate":
                {
                 "latitude":"22.540503",
                 "longitude":"113.934528"
                },
                "need_approval":1
           },
           {
                "meetingroom_id":2,
                "name":"19F-会议室",
                "capacity":20,
                "city":"深圳",
                "building":"腾讯大厦",
                "floor":"19F",
                "equipment":[2,3],
                "coordinate":
                {
                                "latitude":"22.540503",
                                "longitude":"113.934528"
                },
                 "range":
                {
                                "user_list":["zhangsan","lisi"],
                                "department_list":[1]
                 }
           },
           ]
        }

RETURN 参数说明

        参数              说明
        errcode 返回码
        errmsg  对返回码的文本描述内容
        meetingroom_list        满足条件的会议室列表
        meetingroom_list.meetingroom_id 会议室id
        meetingroom_list.name   会议室名称
        meetingroom_list.capacity       会议室容纳人数
        meetingroom_list.city   会议室所在城市
        meetingroom_list.building       会议室所在楼宇
        meetingroom_list.floor  会议室所在楼层
        meetingroom_list.equipment      会议室支持的设备列表
        meetingroom_list.coordinate.latitude    会议室所在楼宇的纬度
        meetingroom_list.coordinate.longitude   会议室所在楼宇的经度
        meetingroom_list.need_approval  是否需要审批 0-无需审批 1-需要审批
        range.user_list 会议室使用范围的userid列表（仅会议室系统应用查询时返回）
        range.department_list   会议室使用范围的部门id列表，（仅会议室系统应用查询时返回）

edit(access_token, hash);

编辑会议室

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/93619#编辑会议室

请求说明：

企业可通过此接口编辑相关会议室的基本信息。

注意，会议室使用范围(range)为覆盖操作，而非增量添加。

请求包结构体为：

        {
          "meetingroom_id":2,
          "name":"18F-会议室",
          "capacity":10,
          "city":"深圳",
          "building":"腾讯大厦",
          "floor":"18F",
          "equipment":[1,2,3],
          "coordinate":
          {
                                "latitude":"22.540503",
                                "longitude":"113.934528"
          },
          "range":
          {
                                "user_list":["zhangsan","lisi"],
                                "department_list":[1]
          }
        }

参数说明：

        参数              必须              说明
        access_token    是       调用接口凭证
        meetingroom_id  是       会议室的id
        name    否       会议室名称，最多30个字符
        capacity        否       会议室所能容纳的人数
        city    否       会议室所在城市
        building        否       会议室所在楼宇
        floor   否       会议室所在楼层
        equipment       否       会议室支持的设备列表,参数详细含义见附录
        coordinate.latitude     否       会议室所在建筑纬度,可通过腾讯地图坐标拾取器获取
        coordinate.longitude    否       会议室所在建筑经度,可通过腾讯地图坐标拾取器获取
        range.user_list 否       会议室使用范围的userid列表，最多指定1000个成员，填写后将覆盖整个使用范围
        range.department_list   否       会议室使用范围的部门id列表，最多指定1000个部门，填写后将覆盖整个使用范围

如果需要修改位置信息，请同时输入城市，楼宇和楼层三个参数，已经生成的建筑，暂不支持修改经纬度。

权限说明

RETURN 返回结果

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

RETURN 参数说明

        参数          说明
    errcode     返回码
        errmsg  对返回码的文本描述内容

del(access_token, hash);

删除会议室

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/93619#删除会议室

请求说明：

企业可通过此接口删除指定的会议室。

请求包体：

    {
        "meetingroom_id":1,
    }

参数说明：

        参数                  必须  说明
    access_token        是       调用接口凭证
    meetingroom_id      是       会议室的id

权限说明

RETURN 返回结果

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

RETURN 参数说明

        参数          说明
    errcode     返回码
        errmsg  对返回码的文本描述内容

附录

当前支持的会议室设备如下

        设备id    设备名称
        1       电视
        2       电话
        3       投影
        4       白板
        5       视频

会议室预定管理

最后更新：2023/12/01

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/93620

权限说明

        应用类型    权限要求
        自建应用    配置到「应用管理 - 会议室 - 可调用接口的应用」中
        代开发应用   暂不支持
        第三方应用   暂不支持

注： 从2023年12月1日0点起，不再支持通过系统应用secret调用接口，存量企业暂不受影响 查看详情

get_booking_info(access_token, hash);

查询会议室的预定信息

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/93620#查询会议室的预定信息

请求说明：

企业可通过此接口查询相关会议室在指定时间段的预定情况，如是否已被预定，预定者的userid等信息，不支持跨天查询。

请求包体：

    {
          "meetingroom_id":1,
          "start_time":1593532800,
          "end_time":1593619200,
          "city":"深圳",
          "building":"腾讯大厦",
          "floor":"18F"
        }

参数说明：

        参数                  必须  说明
    access_token        是       调用接口凭证
        meetingroom_id  否       会议室id
        start_time      否       查询预定的起始时间，默认为当前时间
        end_time        否       查询预定的结束时间， 默认为明日0时
        city    否       会议室所在城市
        building        否       会议室所在楼宇
        floor   否       会议室所在楼层

如果需要根据位置信息查询，则需要保证其上一级的位置信息已填写，即如需使用楼宇进行过滤，则必须同时填写城市字段。

权限说明

RETURN 返回结果

        {
                "errcode": 0,
                "errmsg": "ok",
                "booking_list": [{
                                "meetingroom_id": 1,
                                "schedule": [{
                                        "booking_id": "bkebsada6e027c123cbafAAA",
                                        "schedule_id": "17c7d2bd9f20d652840f72f59e796AAA",
                                        "start_time": 1593532800,
                                        "end_time": 1593662400,
                                        "booker": "zhangsan",
                                        "status":0
                                }]
                        },
                        {
                                "meetingroom_id": 2,
                                "schedule": []
                        }
                ]
        }

RETURN 参数说明

        参数          说明
    errcode     返回码
        errmsg  对返回码的文本描述内容
        booking_list    会议室预订信息列表
        booking_list.meetingroom_id     会议室id
        booking_list.schedule   该会议室查询时间段内的预定情况
        booking_list.schedule.start_time        开始时间的时间戳
        booking_list.schedule.end_time  结束时间的时间戳
        booking_list.schedule.booker    预定人的userid
        booking_list.schedule.status    会议室的预定状态，0：已预定、1：已取消、2：申请中、3：审批中
        booking_list.schedule.booking_id        会议室的预定id
        booking_list.schedule.schedule_id       会议关联日程的id，若会议室已取消预定（未保留日历），则schedule_id将无法再获取到日程详情

book(access_token, hash);

预定会议室

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/93620#预定会议室

请求说明：

企业可通过此接口预定会议室并自动关联日程。

请求包体：

    {
          "meetingroom_id":1,
          "subject":"周会",
          "start_time":1593532800,
          "end_time":1593619200,
          "booker":"zhangsan",
          "attendees":["lisi", "wangwu"]
        }

参数说明：

        参数                  必须  说明
    access_token        是       调用接口凭证
        subject 否       会议主题
        meetingroom_id  是       会议室id
        start_time      是       预定开始时间
        end_time        是       预定结束时间
        booker  是       预定人的userid
        attendees       否       参与人的userid列表

最小预定时长为30分钟； 预定时间和结束时间会自动按30分钟取整，即如果传入的开始和结束时间戳分别对应时间为15:15和15:45，则预定时会自动取整为15:00和16:00； 此API仅可预定无需审批的会议室； 如果当前时间已经晚于预定时间，则按以下情况进行处理： 1.当前已过预定结束时间，则不允许预定 2.当前在预定开始时间15分钟内，则允许预定 3.当前已超过预定开始时间15分钟，则自动转换预定开始时间到下一个时间窗口，即增加30分钟到开始时间

权限说明

RETURN 返回结果

    {
           "errcode": 0,
           "errmsg": "ok"
           "meeting_id":"mtgsaseb6e027c123cbafAAA",
           "schedule_id":"17c7d2bd9f20d652840f72f59e796AAA"
        }

RETURN 参数说明

        参数          说明
    errcode     返回码
        errmsg  对返回码的文本描述内容
        meeting_id      会议的id
        schedule_id     会议关联日程的id

book_by_schedule(access_token, hash);

通过日程预定会议室

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/93620#通过日程预定会议室

请求说明：

企业可通过此接口为指定日程预定会议室，支持重复日程预定。

注意：通过日程预定会议室后，该日程将不能通过更新日程接口进行编辑，而只能调用新增日程参与者与删除日程参与者接口。如果需要更新日程的时间等字段，可以先取消会议室预定，再调用更新日程接口，之后再重新预定会议室。

请求包体：

        {
                "meetingroom_id":1,
                "schedule_id":"1c7e7226edae66468bc48e9859812402",
                "booker":"rocky"
        }

参数说明：

        参数                  必须  说明
    access_token        是       调用接口凭证
        meetingroom_id  是       会议室id
        schedule_id     是       日程id，仅可使用同应用创建的日程
        booker  是       预定人的userid

此API仅可预定无需审批的会议室；

权限说明

RETURN 返回结果

        {
           "errcode": 0,
           "errmsg": "ok"
           "booking_id":"bkgsaseb6e027c123cbafAAA",
           "conflict_date":[1672502400,1675180800,1677600000]
        }

RETURN 参数说明

        参数          说明
    errcode     返回码
        errmsg  对返回码的文本描述内容
        booking_id      会议室的预定的id
        conflict_date   会议室冲突日期列表，为当天0点的时间戳；使用重复日程预定会议室，部分日期与会议室预定情况冲突时返回

book_by_meeting(access_token, hash);

通过会议预定会议室

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/93620#通过会议预定会议室

请求说明：

企业可通过此接口为指定会议预定会议室，支持重复会议预定。

请求包体：

        {
                "meetingroom_id":1,
                "meetingid":"hy7e7226edae66468bc48e9859812402",
                "booker":"rocky"
        }

参数说明：

        参数                  必须  说明
    access_token        是       调用接口凭证
        meetingroom_id  是       会议室id
        meetingid       是       会议id，仅可使用同应用创建的会议
        booker  是       预定人的userid

此API仅可预定无需审批的会议室；

权限说明

RETURN 返回结果

        {
           "errcode": 0,
           "errmsg": "ok"
           "booking_id":"bkgsaseb6e027c123cbafAAA",
           "conflict_date":[1672502400,1675180800,1677600000]
        }

RETURN 参数说明

        参数          说明
    errcode     返回码
        errmsg  对返回码的文本描述内容
        booking_id      会议室的预定的id
        conflict_date   会议室冲突日期列表，为当天0点的时间戳；使用重复日程预定会议室，部分日期与会议室预定情况冲突时返回

cancel_book(access_token, hash);

取消预定会议室

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/93620#取消预定会议室

请求说明：

企业可通过此接口取消会议室的预定。

请求包体：

        {
          "booking_id":"bk42b34949gsaseb6e027c123cbafAAA",
          "keep_schedule":1,
          "cancel_date":1672502400
        }

参数说明：

        参数                  必须  说明
    access_token        是       调用接口凭证
        booking_id      是       会议室的预定id
        keep_schedule   否       是否保留日程，0-同步删除 1-保留，仅对非重复日程有效
        cancel_date     否       对于重复日程，如果不填写此参数，表示取消所有重复预定；如果填写，则表示取消对应日期当天的会议室预定

权限说明

RETURN 返回结果

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

RETURN 参数说明

        参数          说明
    errcode     返回码
        errmsg  对返回码的文本描述内容

get_booking_info_by_meeting_id(access_token, hash);

根据会议ID查询会议室的预定信息

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/93620#根据会议id查询会议室的预定信息

请求说明：

企业可通过此接口按照会议ID查询相关会议室的预定情况。

请求包体：

    {
                "meetingroom_id":1,
                "meeting_id": "mtebsada6e027c123cbafAAA",
        }

参数说明：

        参数                  必须  说明
    access_token        是       调用接口凭证
        meetingroom_id  是       会议室id
        meeting_id      是       会议的id

权限说明

企业需要使用“会议室”secret所获取的accesstoken来调用（accesstoken如何获取？）。 暂不支持第三方调用

RETURN 返回结果

    {
                "errcode": 0,
                "errmsg": "ok",
                "meetingroom_id": 1,
                "schedule": [
                        {
                                "meeting_id": "mtebsada6e027c123cbafAAA",
                                "schedule_id": "17c7d2bd9f20d652840f72f59e796AAA",
                                "start_time": 1593532800,
                                "end_time": 1593662400,
                                "booker": "zhangsan"
                        }
                ]
        }

RETURN 参数说明

    参数      说明
    errcode     返回码
        errmsg  对返回码的文本描述内容
        meetingroom_id  会议室id
        schedule        该会议室的预定情况
        schedule.start_time     开始时间的时间戳
        schedule.end_time       结束时间的时间戳
        schedule.booker 预定人的userid，仅在已预定时返回
        schedule.meeting_id     会议的id，仅在已预定的时返回
        schedule.schedule_id    会议关联日程的id，仅在已预定时返回