Cisco Webex Meetings API 更新概述 (API 41)

在将 Webex 经典版站点转换为控制中心管理的站点后，XML API 支持现有用户验证向前兼容

受影响的 API

将Webex经典站点转换为Control Hub管理的站点后，中的元素的值需要与电子邮件相同，详细信息如下：

• 对于在 Webex 经典版站点中创建的现有用户，我们支持旧的 webExID （例如：Jack）和新的 webExID（内容与电子邮件相同，例如：Jack@xx.com），以便登录，此验证向后兼容适用于所有 XML API。

• 对于在控制中心管理的站点中创建的新用户 ，webExID 元素的值必须与登录电子邮件中的相同。

{siteName}
{userName} ---现有用户是在webEx经典站点中创建的，可以是：jack或jack@xx.com；新用户必须使用jack@xx.com
xxxx或或或

影响 API：

所有 XML API。

在Webex经典站点转换为Control Hub管理的站点后，元素<bodyContent>的值需要与电子邮件相同，详细信息如下：

• 对于在Webex经典站点中创建的现有用户，我们支持旧的webExId(例如：Jack）和新的 webExId（内容与电子邮件相同，例如：Jack@xx.com），位置是在 bodyContent 中。

• 对于在Control Hub管理的站点中创建的新用户，webExId 元素的值必须与 bodyContent中的电子邮件相同。

<bodyContent xsi：type="java：com.webex.service.binding.user.GetUser或SetUser或DelUser"
><webExId>xxxx</webExId> ---现有用户是在webEx经典站点中创建的，它可以是：jack或jack@xx.com；新用户必须使用jack@xx.com

影响 API： User、 User、 User。

架构更改

任何 API 均没有架构更改。

API 请求和响应示例

GetUser API请求和响应

API请求：
<？xml version="1.0" encode="UTF-8"?>
<serv：message xmlns：xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns：serv="http://www.webex.com/schemas/2002/06/service"
xsi：schemaLocation="http://www.webex.com/schemas/2002/06/service http://www.webex.com/schemas/2002/06/service/service.xsd">


<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> ---现有用户是在webEx经典站点中创建的，可以是：jack或jack@xx.com；新用户必须使用jack@xx.com
xxxx或或或




xxxx ---已有用户是在webEx经典站点中创建的，可以是：jack或jack@xx.com；新用户必须使用jack@xx.com




响应示例：
…与之前一样

增强录制文件视图历史报告 API，支持 Webex Meetings、Webex Events（新版）和 Webex Events（经典版）

受影响的 API

当前 API：lstrecordaccessHistory 和 lstrecordaccessDetailHistory 仅支持Webex Trainings录制文件视图访问的历史记录报告。这项新增强功能还支持 Webex Meetings、Webex Events（新版）和 Webex Events（经典版）录制文件视图访问的历史记录报告。

架构更改

在 API 请求主体中，我们支持以下 lstrecordaccessHistory API 新架构：

MeetingCenter
TrainingCenter
EventCenter

详细信息

API：lstrecordaccess历史 能够返回Webex Meetings、Webex Events（新版）、Webex Events（经典版）和Webex Trainings的录制文件视图访问的历史记录。

• 如果没有服务类型 在API请求中指定，APIlstrecordaccess历史 仅返回Webex Trainings录制文件视图访问的历史记录。

• 当serviceType 为MeetingCenter时，lstrecordaccessHistory 的API将返回Webex Meetings和Webex Events（新版）录制文件视图访问的历史记录。

• 当serviceType 为EventCenter时，lstrecordaccessHistory的 API将返回Webex Events（经典版）录制文件视图访问的历史记录。

API：lstrecordaccessDetailHistory 可以按recordID 返回Webex Meetings、Webex Events（新版）、Webex Events（经典版）和Webex Trainings的详细信息。

API 请求和响应示例

strecordaccess History API请求和响应

<？xml version="1.0" encode="UTF-8"?>
<serv：message xmlns：xsi="http://www.w3.org/2001/XMLSchema-instance">

<securityContext>
<webExID>{userName}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>


<bodyContent xsi：type="java：com.webex.service.binding.history.LstrecordaccessHistory">
<viewTimeScope>
<viewTimeStart>2021年9月20日00：00：00</viewTimeStart>
<viewTimeEnd>9/28/2021 23：59：59</viewTimeEnd>
</viewTimeScope>
<listControl>
<startFrom>1</startFrom>
<maximumNum>100</maximumNum>
</listControl>
<订单>
<orderBy> DID</orderBy>
<orderAD>ASC</orderAD>
</订单>
<service >
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</service >
</bodyContent>



<？xml version="1.0" encode="UTF-8"?>
<serv：message xmlns：serv="http://www.webex.com/schemas/2002/06/service" xmlns：com="http://www.webex.com/schemas/2002/06/common" xmlns：历史记录="http://www.webex.com/schemas/2002/06/service/history">
<serv：标题>
<serv： >
<serv：result>成功</serv：result>
<serv：gsbStatus>主</serv：gsbStatus>
</serv：回应>
</serv：标题>
<serv：body>
<serv：bodyContent xsi：type="history：lstrecordaccessHistoryResponse" xmlns：xsi="http://www.w3.org/2001/XMLSchema-instance">
<history：recordAccessHistory>
<history：recordID>1XXXXXXX7</history：recordID>
<history：recordName>LstrecordaccessHistory测试TC-20210924,1324-1</history：recordName>
<history：creationTime>09/24/2021 13：28：13</history：creationTime>
<history： >0</history： >
<history：已下载>2</history：已下载>
<history：已查看>1</history：已查看>
<history：timeZoneID>20</history：timeZoneID>
</history：recordAccessHistory>
<history：recordAccessHistory>
<history：recordID>1XXXXXXX7</history：recordID>
<history：recordName>TestErollment_001-20210610,1905-1</history：recordName>
<history：creationTime>2021年6月10日19：10：15</history：creationTime>
<history： >0</history： >
<历史记录：已下载>0</历史记录：已下载>
<history：已查看>3</history：已查看>
<history：timeZoneID>20</history：timeZoneID>
</history：recordAccessHistory>
<history：recordAccessHistory>
<history：recordID>1XXXXXXX7</history：recordID>
<history：recordName>测试即时播放2-20210705,0709-1</history：recordName>
<history：creationTime>2021年7月5日07：15：06</history：creationTime>
<history： >0</history： >
<历史记录：已下载>0</历史记录：已下载>
<history：已查看>1</history：已查看>
<history：timeZoneID>20</history：timeZoneID>
</history：recordAccessHistory>
<history：recordAccessHistory>
<history：recordID>1XXXXXXX7</history：recordID>
<history：recordName>EC2.0_232423-20210922,0447-1</history：recordName>
<history：creationTime>2021年9月22日04：53：05</history：creationTime>
<history： >0</history： >
<历史记录：已下载>0</历史记录：已下载>
<history：已查看>1</history：已查看>
<history：timeZoneID>20</history：timeZoneID>
</history：recordAccessHistory>
<history：recordAccessHistory>
<history：recordID>1XXXXXXX7</history：recordID>
<history：recordName>LstrecordaccessHistory测试EC2.0-20210924,1315-1</history：recordName>
<history：creationTime>2021年9月24日13：19：00</history：creationTime>
<history： >0</history： >
<history：已下载>1</history：已下载>
<history：已查看>1</history：已查看>
<history：timeZoneID>20</history：timeZoneID>
</history：recordAccessHistory>
<history：recordAccessHistory>
<history：recordID>1XXXXXXX7</history：recordID>
<history：recordName>LstrecordaccessHistory测试MC-20210924,1319-1</history：recordName>
<history：creationTime>2021年9月24日13：25：12</history：creationTime>
<history： >0</history： >
<history：已下载>1</history：已下载>
<history：已查看>1</history：已查看>
<history：timeZoneID>20</history：timeZoneID>
</history：recordAccessHistory>
<history：recordAccessHistory>
<history：recordID>1XXXXXXX7</history：recordID>
<history：recordName>LstrecordaccessHistory测试EC classic-20210924,1331-1</history：recordName>
<history：creationTime>09/24/2021 13：37：28</history：creationTime>
<history： >0</history： >
<history：已下载>1</history：已下载>
<history：已查看>1</history：已查看>
<history：timeZoneID>20</history：timeZoneID>
</history：recordAccessHistory>
<history： Record>
<serv：total>8</serv：total>
<serv：return>7</serv：return>
<serv：startFrom>1</serv：startFrom>
</history： Record>
</serv：bodyContent>

lstrecordaccessDetail History API请求和响应

<？xml version="1.0" encode="UTF-8"?>
<serv：message xmlns：xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns：serv="http://www.webex.com/schemas/2002/06/service">

<securityContext>
<webExID>{userName}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>


<bodyContent xsi：type=
"java：com.webex.service.binding.history.LstrecordaccessDetailHistory">
<recondID>1XXXXXX7</recondID>
<timeZoneID>20</timeZoneID>




<？xml version="1.0" encode="UTF-8"?>
<serv：message xmlns：serv="http://www.webex.com/schemas/2002/06/service" xmlns：com="http://www.webex.com/schemas/2002/06/common" xmlns：历史记录="http://www.webex.com/schemas/2002/06/service/history">
<serv：标题>
<serv： >
<serv：result>成功</serv：result>
<serv：gsbStatus>主</serv：gsbStatus>
</serv：回应>
</serv：标题>
<serv：body>
<serv：bodyContent xsi：type="history：lstrecordaccessDetailHistoryResponse" xmlns：xsi="http://www.w3.org/2001/XMLSchema-instance">
<history：recordDetail>
<history：viewID>1XXXXXX7</history：viewID>
<history：participantName>Axxxg</history：participantName>
<history：participantEmail>Axxxg@qa.webex.com</history：participantEmail>
<history：accessTime>2021年9月24日13：27：26</history：accessTime>
<history： >false</history： >
<history：已下载>false</history：已下载>
<history：已查看>true</history：已查看>
<history：timeZoneID>20</history：timeZoneID>
</history：recordDetail>
<history：recordDetail>
<history：viewID>1XXXXXX7</history：viewID>
<history：participantName>Axxxg</history：participantName>
<history：participantEmail>Axxxg@qa.webex.com</history：participantEmail>
<history：accessTime>2021年9月24日13：27：39</history：accessTime>
<history： >false</history： >
<history：已下载>true</history：已下载>
<history：查看>false</history：查看>
<history：timeZoneID>20</history：timeZoneID>
</history：recordDetail>
<history： Record>
<serv：total>2</serv：total>
<serv： >2</serv： >
<serv：startFrom>1</serv：startFrom>
</history： Record>
</serv：bodyContent>

影响 API：

• lstrecordaccess历史

• lstrecordaccessDetailHistory

修复了 XMLAPI 和 Webex 页面之间的 Webex Events（经典版）描述的最大长度。

受影响的 API

XML API：CreateEvent 和 SetEvent 的描述 元素最多允许输入10000个字符，如果输入超过大小，将导致新的错误代码和消息：

060068 非法的输入描述。描述不能超过 10000 个字符。

架构更改

没有架构更改。

API 请求和响应示例

Event API请求和响应

#API请求示例：
…

<bodyContent xsi：type="java：com.webex.service.binding.event.CreateEvent"
xmlns：att="http://www.webex.com/schemas/2002/06/service/event" xsi：schemaLocation="http://www.webex.com/schemas/2002/06/service/event http://www.webex.com/schemas/2002/06/service/event/event.xsd">
<accessControl>
<sessionPassword>1111111</sessionPassword>
< >私人
</accessControl>
<metaData>
<sessionName>EC测试</sessionName>
<description>……。假设您在描述中填写10000个字符……</description>
</metaData>
…


------------------------------------ ------------------------------------
描述超过10000个字符时的#API响应示例：

<serv：message xmlns：serv="http://www.webex.com/schemas/2002/06/service" xmlns：com="http://www.webex.com/schemas/2002/06/common" xmlns：event="http://www.webex.com/schemas/2002/06/service/event">


<serv：result>失败</serv：result>
非法输入说明。描述不能超过10000个字符<serv：gsbStatus>PRIMARY</serv：gsbStatus>
<serv：exceptionID>
060068</serv：exceptionID> <
/serv：response>

<serv：body>
<serv：bodyContent/>
</serv：body>

影响 API：

• CreateEvent

• SetEvent

XML API: GetUser 返回 freeAccount 的新元素

受影响的 API

GetUser 返回一个新元素，用于识别freeAccount 用户帐户是否为 FreeAccount 。

架构更改

GetUser 响应示例

GetUser响应：<use：initi >
AW</use：initi >
<use：isUploated>false</use：isUploated>


<use：freeAccount>false</use：freeAccount>
Content>

影响 API：

GetUser