文档首页> 会议> 服务端API参考> 会议管理> 接口参考> 编辑预约会议
更新时间：2022-05-05 GMT+08:00
查看PDF
分享

编辑预约会议

描述

编辑预约会议。会议开始后，不能被编辑。

修改会议参数时，需要填写所有预约会议时设置的参数，不能只填要修改的参数，否则不填的参数会被恢复成默认值。

调试

您可以在API Explorer中调试该接口。

接口原型

表1 接口原型

请求方法

PUT

请求地址

/v1/mmc/management/conferences

传输协议

HTTPS

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

conferenceID

是

String

Query

会议ID。

userUUID

否

String

Query

用户的UUID（已在USG注册过的)。

X-Access-Token

是

String

Header

授权令牌。获取“执行App ID鉴权”响应的accessToken。

X-Authorization-Type

否

String

Header

标识是否为第三方portal过来的请求。

X-Site-Id

否

String

Header

用于区分到哪个HCSO站点鉴权。

startTime

否

String

Body

会议开始时间（UTC时间）。

说明：

创建预约会议时，如果没有指定开始时间或填空串，则表示会议马上开始。

格式：yyyy-MM-dd HH:mm

length

否

Integer

Body

会议持续时长，单位分钟，最大值为1440，最短15。default: 30。

subject

否

String

Body

会议主题。长度限制为128个字符。

mediaTypes

是

String

Body

会议的媒体类型。

由1个或多个枚举String组成，多个枚举时，每个枚举值之间通过“，”逗号分隔，枚举值如下：

  • "Voice”：语音。
  • "Video”：标清视频。
  • "HDVideo”：高清视频（与Video互斥，如果同时选择Video、HDVideo，则系统默认选择Video）。
  • "Telepresence”：智真(与HDVideo、Video互斥，如果同时选择，系统使用Telepresence)。（预留字段）
  • "Data”：多媒体（系统配置决定是否自动添加Data）。

groupuri

否

String

Body

软终端创建即时会议时在当前字段带临时群组ID，由服务器在邀请其他与会者时在或者conference-info头域中携带。 长度限制为31个字符。

attendees

否

Array of Attendee objects

Body

与会者列表。该列表可以用于发送会议通知、会议提醒、会议开始时候进行自动邀请。

cycleParams

否

CycleParams object

Body

周期会议的参数，当会议是周期会议的时候该参数必须填写，否则服务器忽略该参数。

该参数包括周期会议的开始日期、结束日期、会议的周期和周期中的开会时间点。

isAutoRecord

否

Integer

Body

会议是否自动启动录制，在录播类型为：录播、录播+直播时才生效。默认为不自动启动。

  • 1：自动启动录制。
  • 0：不自动启动录制。

encryptMode

否

Integer

Body

会议媒体加密模式。默认值由企业级的配置填充。

  • 0：自适应加密。
  • 1 : 强制加密。
  • 2 : 不加密。

language

否

String

Body

会议的默认语言，默认值由会议云服务定义。

对于系统支持的语言，按照RFC3066规范传递。

  • zh-CN：简体中文。
  • en-US：美国英文。

timeZoneID

否

String

Body

会议通知中会议时间的时区信息。时区信息，参考时区映射关系。

说明：
  • 举例：“timeZoneID”:"26"，则通过华为云会议发送的会议通知中的时间将会标记为如“2021/11/11 星期四 00:00 - 02:00 (GMT) 格林威治标准时间:都柏林, 爱丁堡, 里斯本, 伦敦”。
  • 如果会议通知是通过第三方系统发送，则这个字段不用填写。

recordType

否

Integer

Body

录播类型。默认为禁用。

  • 0: 禁用 。
  • 1: 直播 。
  • 2: 录播。
  • 3: 直播+录播。

liveAddress

否

String

Body

主流直播地址，最大不超过255个字符，在录播类型为：直播、录播+直播时有效。

auxAddress

否

String

Body

辅流直播地址，最大不超过255个字符，在录播类型为：直播、录播+直播时有效。

recordAuxStream

否

Integer

Body

是否录制辅流，在录播类型为：录播、录播+直播时有效。

  • 0：不录制。
  • 1：录制。

confConfigInfo

否

ConfConfigInfo object

Body

会议其他配置信息。

recordAuthType

否

Integer

Body

录播鉴权方式，在录播类型为:录播、直播+录播时有效。

  • 0：可通过链接观看/下载。
  • 1：企业用户可观看/下载。
  • 2：与会者可观看/下载。

vmrFlag

否

Integer

Body

是否使用云会议室召开预约会议。默认不使用云会议室。

  • 0：不使用云会议室。
  • 1：使用云会议室。

vmrID

否

String

Body

用于识别用户开会时绑定的云会议室。最大长度不超过512个字符。

  • 不为空，则用ID查询云会议室信息。
  • 为空，则查用户所有云会议室，如果有个人会议ID，用个人会议ID；没有个人会议ID，取最小云会议室ID。

concurrentParticipants

否

Integer

Body

会议方数，会议最大与会人数限制。

  • 0：无限制。
  • 大于0：会议最大与会人数。

状态码

表3 状态码说明

HTTP状态码

描述

200

操作成功。

400

参数异常。

401

未鉴权或鉴权失败。

403

权限受限。

500

服务端异常。

响应参数

表4 响应参数

参数

类型

描述

[数组元素]

Array of ConferenceInfo

会议信息列表。

请求消息示例

PUT /v1/mmc/management/conferences?conferenceID=914087436
Connection: keep-alive
X-Access-Token: stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC
Content-Type: application/json
user-agent: WeLink-desktop
Content-Length: 372
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

{
    "mediaTypes": "Video,Voice",
    "startTime": "2019-12-23 00:00",
    "length": 120,
    "attendees": [
        {
            "accountId": "user01",
            "name": "user01",
            "role": "0",
            "phone": "+991116003815",
            "isMute": "1"
        }
    ],
    "conferenceType": 0,
    "subject": "user01的会议"
}

响应消息示例

HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 1157
Connection: keep-alive
http_proxy_id: 462abfcfa8a41c2c5450eb7648bf5ad2
Server: api-gateway
X-Request-Id: 7ba6f742610c03a64262b126fb336a5d

[
    {
        "conferenceID": "914087436",
        "mediaTypes": "Data,Video,Voice",
        "subject": "user01的会议",
        "size": 1,
        "timeZoneID": "56",
        "startTime": "2019-12-23 00:00",
        "endTime": "2019-12-23 02:00",
        "conferenceState": "Schedule",
        "accessNumber": "+991117",
        "language": "zh-CN",
        "passwordEntry": [
            {
                "conferenceRole": "chair",
                "password": "881824"
            },
            {
                "conferenceRole": "general",
                "password": "787209"
            }
        ],
        "userUUID": "ff808081699b56cb0169be103500012b",
        "scheduserName": "user8002",
        "multiStreamFlag": 1,
        "conferenceType": 0,
        "confType": "FUTURE",
        "isAutoMute": 1,
        "isAutoRecord": 0,
        "chairJoinUri": "https://c.meeting.huaweicloud.com/#/j/914087436/411170cda30af7327be723ef63d5ab8900a3b773be496604",
        "guestJoinUri": "https://c.meeting.huaweicloud.com/#/j/914087436/052ee23f08966bc6221fc363500e9843f2356349de9d106c",
        "recordType": 0,
        "recordAuxStream": 0,
        "confConfigInfo": {
            "isSendNotify": true,
            "isSendSms": true,
            "isAutoMute": true
        },
        "vmrFlag": 0,
        "scheduleVmr": false,
        "isHasRecordFile": false,
        "partAttendeeInfo": [
            {
                "phone": "+991116003815",
                "name": "user01",
                "type": "normal"
            }
        ],
        "terminlCount": 0,
        "normalCount": 1,
        "deptName": "wangyue"
    }
]

错误码

当您使用华为云会议服务端API时，如果遇到“MMC”或者“USG”开头的错误码，请参考华为云API错误中心。

CURL命令示例

curl -k -i -H 'content-type: application/json' -X PUT -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' -d '{"mediaTypes": "Voice","attendees": [{"name": "user02","role": 1,"phone": "+8657*******"}],"conferenceType": "0","subject": "user02 conference"}' 'https://api.meeting.huaweicloud.com/v1/mmc/management/conferences?conferenceID=914087436'
父主题： 接口参考
分享：

    相关文档

    相关产品

关闭导读