- Главная
- /
- Статья
Обзор обновлений API Cisco Webex Meetings (API 41)
Найдите всю необходимую информацию о Cisco Webex Meetings API, например изменения схемы и другие объявления.
Дополнительную информацию об XML API 39 и XML API 11 см. в статье Обзор обновлений XML API Cisco Webex Meetings (XML API 39 и более ранние версии).
Дополнительную информацию об API XML 40 см. в статье Обзор обновлений API XML Cisco Webex Meetings (API XML 40 и последующие версии).
Информацию об обновлениях XML API 11 SP9 и более ранних выпусков см. в разделе Cisco DevNet.
Обновления API 41.12.0
Обновления API XML 41.12.0
XMLAPI блокирует планирование и редактирование Webex Events (классическая версия) в соответствии с элементом конфигурации веб-сайта EnableClassicEvent
, который является ложным
Затронутые API и изменения схемы
Если на странице конфигурации службы администрирования веб-сайта флажок параметра Включить классическую версию event-совещаний не установлен, этот сайт не будет поддерживать совещания Webex Events (классическая версия).
Если флажок параметра Включить классическую версию event-совещаний не установлен, вы можете воспользоваться этими API для работы с Webex Events (классическая версия).
CreateEvent
, SetEvent
, GetEvent
, GetSessionInfo
, LstsummaryEvent
, LstrecordedEvent
, LstsummaryProgram
, ЗагрузитьEventImage
API ответит на новое исключение 010106 Классическое событие отключено.
Изменения схемы
В схеме нет изменений.
Пример запроса и ответа API
Запрос и ответ API CreateEvent
Запрос CreateEvent
XXXXXXXX
XMLAPI EC Testing
17.07.2021 01:29:15
15
>
Ответ CreateEvent
<?xml version="1.0" encoding="ISO-8859-1"?>
<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:header>
<serv:response>
<serv:result>СБОЙ</serv:result>
<serv:reason>Классическое событие отключено.</serv:reason>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
<serv:exceptionID>010106</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
CreateEvent3.1.3 Влияние на API:
-
SetEvent GetEvent
-
GetSessionInfo
-
LstsummaryEvent
-
LstrecordedEvent
-
LstsummaryProgram
-
UploadEventImage
XMLAPI LstMeetingType
будет отвечать на новый элемент subProductCodePrefix
Impacted API(API)
Текущий элемент ответа API LstMeetingType
из productionCodePrefix
: PRO, AUO и другие, которые являются предопределенным префиксом типа meet Webex.
После этого нового усовершенствования API будет отвечать на новый элемент subProdctCodePrefix
:PRO1, PRO2 и т.д., который можно настроить префикс типа meet.
Изменения схемы в API: LstMeetingType
Будет отвечать с новым элементом: subProdctCodePrefix
Пример запроса и ответа API
Запрос и ответ API
LstMeetingType
Запрос LstMeetingType
13810
Ответ LstMeetingType
<serv:bodyContent xsi:type="mtgtype:lstMeetingTypeResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<mtgtype:matchingRecords>
<serv:total>1</serv:total>
<serv:returned>1</serv:returned>
<serv:startFrom>1</serv:startFrom>
</mtgtype:matchingRecords>
<mtgtype:productCodePrefix>PRO</mtgtype:productCodePrefix>
<mtgtype:subProductCodePrefix>PRO3</mtgtype:subProductCodePrefix> //Новый элемент для пользовательского типа совещания
<mtgtype:active>ACTIVATED</mtgtype:active>
<mtgtype:name>Cus_Chat_Закрыто</mtgtype:name>
<mtgtype:displayName>Cus_Chat_Закрыто</mtgtype:displayName>
Обновления API 41.11.0
Обновления API XML 41.11.0
Поддержка прямой совместимости API XML в API управления пользователями для веб-сайтов под управлением Control Hub
Затронутые API и изменения схемы
Если в настоящее время приложение интеграции использует API управления пользователями Webex XMLAPI: CreateUser
, SetUser
, DelUser
, и GetUser
для подготовки пользователей или управления ими после преобразования классического веб-сайта Webex в веб-сайт под управлением Control Hub эти API будут продолжать работать для обеспечения совместимости при переадресации. Ниже приведены некоторые изменения в поведении.
-
При использовании createUser – если состояние пользователя в Control Hub не "активный", пользователь на веб-сайте также не будет активным. Если состояние пользователя в Control Hub активный, пользователь на веб-сайте также будет активным. Источник: Состояние новых и преобразованных пользователей в Control Hub.
-
Элемент пароля API CreateUser и SetUser будет проигнорирован. Мы начнем рассылку электронных сообщений со ссылкой на активацию для новых пользователей. Пользователи могут перейти по ссылке в электронном письме, чтобы активировать новую учетную запись и ввести новый пароль.
-
Активный элемент API CreateUser будет проигнорирован. Новый пользователь (не проверяется) не может быть активирован с помощью этого параметра с помощью API SetUser.
-
Значение элемента webExId в bodyContent API CreateUser должно быть таким же, как и адрес электронной почты. Если webExId отличается от электронной почты, при хранении в WebDB webExId будет обрабатываться так же, как и электронная почта, и значение будет проигнорировано.
-
Значением элемента webExId в bodyContent API SetUser должно быть идентификатор адреса электронной почты пользователя. Его можно изменить с помощью <email> в bodyContent.
-
API SetUser поддерживает изменение адреса электронной почты существующего пользователя в следующем случае: если учетная запись операции в SecurityContext является администратором веб-сайта с полными правами в Control Hub. В противном случае API выдаст сообщение об ошибке вместе с новым кодом ошибки:
-
030120 Для изменения адреса электронной почты учетная запись должна быть администратором веб-сайта с полными правами.
-
-
Элемент newWebExId в bodyContent API SetUser будет проигнорирован.
-
API SetUser пытается изменить адрес электронной почты на тот, который уже используется. API выдаст сообщение об ошибке вместе с новым кодом ошибки:
-
030118 Электронная почта уже используется на веб-сайтах под управлением Control Hub.
-
-
API DelUser деактивирует учетную запись пользователя на стороне совещания Webex и удаляет его лицензию на совещания на веб-сайте Webex. Деактивированный пользователь может быть повторно активирован с помощью API. SetUser (ACTIVATED), пока пользователь был подтвержден ранее.
-
API CreateUser и SetUser выдают сообщение об ошибке вместе с новым кодом ошибки, как показано ниже:
-
030117, этот пользователь существует за пределами вашей организации, поэтому он должен быть заявлен для перехода в вашу организацию с помощью процесса утверждения пользователя. Чтобы получить информацию о том, какие действия необходимо предпринять для утверждения пользователя в организации, см. Утверждение пользователей в вашей организации (преобразование пользователей). Прежде чем утверждать пользователя, необходимо проверить домен, к которому принадлежит пользователь.
-
030119 Маркер доступа CI должен включать область webexsquare: администратора при подготовке пользователя к работе.
-
Прямая совместимость поддерживается только в течение ограниченного периода времени. Перед удалением этой совместимости будет отправлено предварительное уведомление.
Изменения схемы
В схеме этих API нет изменений: CreateUser
, SetUser
, DelUser
и GetUser
.
Пример запроса и ответа API
Запрос и ответ API CreateUser
Запрос API:
<?xml version="1.0" encoding="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">
<заголовок>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{учетная запись администратора веб-сайта}</webExID>
<email>{учетная запись администратора веб-сайта}</email>
<sessionTicket>xxxx</sessionTicket>, или
или при использовании CI "accessToken" он должен включать область применения webexsquare:admin при подготовке пользователя
</securityContext>
</заголовок>
<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/></head><body>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<webExId>Jack@qa.webex.com</webExId> --- это должен быть идентификатор адреса электронной почты пользователя
<email>Jack@qa.webex.com</email>
<firstName>Jack</firstName>
<lastName>Smith</lastName>
<password>....</password>
<привилегия>
<host>true</host>
</привилегия>
<active>ACTIVATED</active> — этот параметр не может активировать пользователя напрямую до тех пор, пока пользователь сам не активирует себя по электронной почте для активации.
</bodyContent>
</body>
Пример ответа API:
<?xml version="1.0" encoding="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:use="http://www.webex.com/schemas/2002/06/service/user">
<serv:header>
<serv:response>
<serv:result>УСПЕХ</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="use:createUserResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<use:userId>23778617</use:userId>
</serv:bodyContent>
Затронутые API:
-
CreateUser
-
SetUser
-
DelUser
API XML поддерживает прямую совместимость аутентификации существующих пользователей классической версии веб-сайта Webex и конвертированного веб-сайта под управлением Control Hub
Затронутые API
После преобразования классического веб-сайта Webex в веб-сайт под управлением Control Hub значение элемента в должно совпадать с адресом электронной почты. Подробности ниже.
-
Для существующих пользователей, созданных в классической версии веб-сайта Webex, поддерживаются оба старых webExID (например, Jack) и новый webExID (контент совпадает с адресом электронной почты. Пример: Jack@xx.com) для входа. Обратная совместимость аутентификации существует для всех API XML.
-
Для новых пользователей, созданных на веб-сайтах под управлением Control Hub, значение элемента webExID должно совпадать с адресом электронной почты для входа в систему.
{siteName}
{userName} -- существующие пользователи были созданы на классическом веб-сайте webEx. Это могут быть: jack или jack@xx.com; новый пользователь должен использовать jack@xx.com
xxxx или , или
Затронутые API:
Все API XML
После преобразования классического веб-сайта Webex в веб-сайт под управлением Control Hub значение элемента <bodyContent> должно совпадать с адресом электронной почты. Подробности ниже.
-
Для существующих пользователей, созданных на классическом веб-сайте Webex, поддерживаются оба старых webExId(например: Jack) и новый webExID (контент совпадает с адресом электронной почты. Пример: Jack@xx.com) в bodyContent.
-
Для новых пользователей, созданных на веб-сайтах под управлением Control Hub, значение элемента webExId должно совпадать с адресом электронной почты в
bodyContent
.
xxxx -- существующие пользователи были созданы на классическом веб-сайте webEx. Это могут быть: jack или jack@xx.com; новый пользователь должен использовать jack@xx.com
Затронутые API: GetUser
, SetUser
и DelUser
.
Изменения схемы
В схеме всех API нет изменений:
Пример запроса и ответа API
Запрос и ответ API GetUser
Запрос API:
<?xml version="1.0" encoding="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 or jack@xx.com; новый пользователь должен использовать jack@xx.com
xxxx или или или
xxxx -- существующие пользователи были созданы на классическом веб-сайте webEx: jack или jack@xx.com; новый пользователь должен использовать jack@xx.com
API response example:
...same as before
Усовершенствование API отчета о просмотре истории записей поддерживается в Webex Meetings, Webex Events (новая версия) и Webex Events (классическая версия)
Затронутые API
Текущий API: lstrecordaccessHistory
и lstrecordaccessDetailHistory
поддерживают только отчет истории просмотра записей Webex Training. Новые усовершенствования добавляют поддержку отчетов о просмотре истории записей в Webex Meetings, Webex Events (новая версия) и Webex Events (классическая версия).
Изменения схемы
Ниже приведена новая схема в API lstrecordaccessHistory в теле запроса API:
MeetingCenter
TrainingCenter
EventCenter
Сведения
API: lstrecordaccess
может возвращать историю просмотра записей для Webex Meetings, Webex Events (новая версия), Webex Events (классическая версия) и Webex Training.
-
Если в запросе API serviceType не указан, API
lstrecordaccessHistory
возвращает только историю просмотра записей Webex Training. -
Если serviceType – MeetingCenter, API
lstrecordaccessHistory
возвращает историю просмотра записей Webex Meetings и Webex Events (новая версия). -
Если serviceType – EventCenter, API
lstrecordaccessHistory
возвращает историю доступа к просмотру записей Webex Events (классическая версия).
API: lstrecordaccessDetailHistory
может возвращать сведения по идентификатору записи
Webex Meetings, Webex Events (новая версия), Webex Events (классическая версия) и Webex Training.
Пример запроса и ответа API
lstrecordaccess
History запрос и ответ API
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<заголовок>
<securityContext>
<webExID>{userName}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>
</заголовок>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.history.LstrecordaccessHistory">
<viewTimeScope>
<viewTimeStart>20.09.2021 00:00:00</viewTimeStart>
<viewTimeEnd>28.09.2021 23:59:59</viewTimeEnd>
</viewTimeScope>
<listControl>
<startFrom>1</startFrom>
<maximumNum>100</maximumNum>
</listControl>
<order>
<orderBy> DID</orderBy>
<orderAD>ASC</orderAD>
</order>
<serviceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</serviceTypes>
</bodyContent>
</body>
<?xml version="1.0" encoding="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:history="http://www.webex.com/schemas/2002/06/service/history">
<serv:header>
<serv:response>
<serv:result>УСПЕХ</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<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 test TC-20210924 1324-1</history:recordName>
<history:creationTime>24.09.2021 13:28:13</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>2</history:downloaded>
<history:viewed>1</history:viewed>
<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>10.06.2021 19:10:15</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>3</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>Тестирование мгновенного воспроизведения 2-20210705 0709-1</history:recordName>
<history:creationTime>05.07.2021 07:15:06</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>1</history:viewed>
<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>22.09.2021 04:53:05</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory test EC2.0-20210924 1315-1</history:recordName>
<history:creationTime>24.09.2021 13:19:00</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory test MC-20210924 1319-1</history:recordName>
<history:creationTime>24.09.2021 13:25:12</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory test EC classic-20210924 1331-1</history:recordName>
<history:creationTime>24.09.2021 13:37:28</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:matchingRecords>
<serv:total>8</serv:total>
<serv:returned>7</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
</serv:bodyContent>
lstrecordaccessDetailHistory
запрос и ответ API
<?xml version="1.0" encoding="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>
</заголовок>
<body>
<bodyContent xsi:type=
"java:com.webex.service.binding.history.lstrecordaccessDetailHistory">
<recondID>1XXXXXX7</recondID>
<timeZoneID>20</timeZoneID>
</bodyContent>
<?xml version="1.0" encoding="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:history="http://www.webex.com/schemas/2002/06/service/history">
<serv:header>
<serv:response>
<serv:result>УСПЕХ</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<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>24.09.2021 13:27:26</history:accessTime>
<history:registered>false</history:registered>
<history:downloaded>false</history:downloaded>
<history:viewed>true</history:viewed>
<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>24.09.2021 13:27:39</history:accessTime>
<history:registered>false</history:registered>
<history:downloaded>true</history:downloaded>
<history:viewed>false</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordDetail>
<history:matchingRecords>
<serv:total>2</serv:total>
<serv:returned>2</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
</serv:bodyContent>
Затронутые API:
-
lstrecordaccessHistory
-
lstrecordaccessDetailhistory
Исправьте несоответствие максимальной допустимой длины описания Webex Events (Classic) между XMLAPI и страницей Webex.
Затронутые API
XML API: CreateEvent и SetEvent элемент описания позволит ввод не более 10000 символов, если ввод превышает размер, это приведет к появлению нового кода ошибки и сообщения:
060068 Введено недопустимое описание. Длина описания превышает 10 000 символов.
Изменения схемы
Нет изменений схемы.
Пример запроса и ответа API
Запрос и ответ API CreateEvent
Пример запроса #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>111111</sessionPassword>
<listing>PRIVATE</listing>
</accessControl>
<metaData>
<sessionName>Тест EC</sessionName>
<description>........Предположим, вы заполняете 10000 символов в описании........</description>
</metaData>
...
------------------------------------
#API response example when the description exceeds 10000 characters:
<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 символов
PRIMARY
060068
Затронутые API:
-
CreateEvent
-
SetEvent
API XML: GetUser возвращает новый элемент freeAccount
Затронутые API
GetUser
возвращает новый элемент, который определяетfreeAccount
учетная запись пользователя является FreeAccount
или нет.
Изменения схемы
Пример ответа GetUser
Ответ GetUser:
AW
false
3
false
>
Затронутые API:
GetUser
Обновления API 41.10.0
В схеме API XML 41.10.0 нет изменений.
Обновления API 41.9.0
Обновления API XML 41.9.0
Вывод из эксплуатации API XML 10.0.0 для всех веб-сайтов T31
Webex планирует завершить поддержку API XML версии 10.0.0 для всех веб-сайтов T31.
В обновлении 41.9.0 из всех продуктов будет исключен код API XML версии 10.0.0.
Обновления API 41.8.0
Обновления API XML 41.8.0
Вывод из эксплуатации API XML 10.0.0 для всех веб-сайтов T31
Webex планирует завершить поддержку API XML версии 10.0.0 для всех веб-сайтов T31.
Webex обнаружил, что некоторые клиенты обращаются к URL-адресу API XML некорректным способом: https://{siteName}.webex.com/WBXService/xml10.0.0/XMLService. Правильный способ доступа к URL-адресу API XML: https://{siteName}.webex.com/WBXService/XMLService.
Испрвальте путь доступа для кода API XML, чтобы избежать негативных последствий до того, как поддержка API XML версии 10.0.0 будет завершена.
Обновления API 41.7.0
Обновления API XML 41.7.0
Удаление и редактирование записей с помощью мобильных устройств должно управляться параметром администрирования веб-сайта: Разрешить организаторам переназначать, редактировать, отключать и удалять записи
Затронутые API и изменения схемы
GetSite
: возвращает новые элементы с именем enableNBRMCModify
и separateNoRecordingEdit
под инструментами.
Пример ответа
GetSiteResponse
:
GetSite
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:ns1="http://www.webex.com/schemas/2002/06/service/site" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:response>
<serv:result>УСПЕХ</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
<ns1:tools>
...
<ns1:enableNBRMCModify>false</ns1:enableNBRMCModify>
<ns1:separateNoRecordingEdit>true</ns1:separateNoRecordingEdit>
...
</ns1:tools>>
</serv:bodyContent>
Обновления API 41.6.3
Обновления API XML 41.6.3
GetSite
Response новый элемент supportLargeEvent
Затронутые API и изменения схемы
GetSite: возвращает новые элементы с именем supportLargeEvent
в разделе siteCommonOptions
, чтобы сообщить вызывающему абоненту, поддерживает ли веб-сайт Large Event (Webex Event (новая версия)) или нет.
Изменение схемы
Пример ответа
GetSiteResponse
:
GetSite
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:ns1="http://www.webex.com/schemas/2002/06/service/site" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:response>
<serv:result>УСПЕХ</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
<ns1:siteCommonOptions>
...
<ns1:enablePreMeetingLobby>false</ns1:enablePreMeetingLobby>
<ns1:supportLargeEvent>true</ns1:supportLargeEvent>
</ns1:siteCommonOptions>
</serv:bodyContent>
Обновления API 41.6.0
Обновления API XML 41.6.0
API XML поддерживает Webex Events 2.0 в процессе предоставления
Затронутые API
GetUser
: возвращает новый элемент с именем largeEventCapacity
, который показывает емкость нового Event 2.0 (EC 2.0) под этой учетной записью пользователя. Например, если учетная запись пользователя имеет лицензию CI_EC3K, значение largeEventCapacity
равно 3000.
Изменения схемы
Пример ответа
GetUserResponse:
Значение CreateTime LstRecording API XML применяется к началу записи
Затронутые API
LstRecording
: LstRecording
ответ CreateTime
как время, когда пользователь действительно нажимает кнопку записи.
Подробности
В прошлом API XML использовал отметку времени создания записи в базе данных в качестве времени создания в ответе LstRecording
. Теперь это время, когда пользователь фактически начинает запись. Это изменение применяется ко всем записям службы. Изменения схемы отсутствуют.
Обновления API 41.5.0
Обновления API XML 41.5.0
С помощью API XML можно начинать запланированные совещания Webex из сети PSTN в качестве организатора
Затронутые API
-
CreateUser
: генерируетhostPIN
независимо от того, включена ли PMR пользователя, если роль пользователя является организатором, администраторами веб-сайта с полными правами, правами на чтение или правами управления пользователями. -
SetUser
: устанавливаетhostPIN
с помощьюphones.hostPIN
, когдаpersonalMeetingRoom.hostPIN
отсутствует в запросе XML (предварительное условие: переключатель функцииAllowStartScheduledMtgFromPhone
включен). -
GetUser
: возвращаетphones.hostPIN
независимо от того, включена ли PMR пользователя. (предварительное условие: переключатель функцииAllowStartScheduledMtgFromPhone
включен).
Изменения схемы
GetUserResponse
:
SetUser
:
Пример ответа
GetUserResponse
:
SetUser
:
Ответ XMLAPI GetSite
два новых элемента для мобильного клиента
Impacted API(API)
-
GetSite
:GetSite
теперь ответит на два новых элемента для поддержки мобильного клиента с логикой отображения или неотображения вкладки записи.-
enableRecordingAccess
: true или false, суперадминистраторы Webex могут включить или отключить доступ к записи с помощью переключателя (EnableRecordingAccesses
). -
storageEmptyStatus
: true или false. Если оба веб-сайта не поддерживают функцию сетевых записей и выделяют пространство хранилища сетевых записей как нулевое, ответ о состоянии соответствует действительности, в противном случае является ложным.
-
Изменения схемы
Пример запроса для GetSite
Пример ответа для Getsite
Тема электронного сообщения, которая содержит символы, не относящиеся к коду ASCII, будет зашифрована по стандарту RFC 2047. Если же тема электронного сообщения содержит только символы ASCII, кодирование не требуется.
Затронутые APIЭто не влияет на полезную нагрузку запроса или ответа API, однако меняет поведение кодирования темы электронного сообщения. Если тема сообщения электронной почты содержит символы, не относящиеся к коду ASCII, она будет зашифрована по стандарту RFC 2047. Если же тема сообщения электронной почты содержит только символы ASCII, кодирование не требуется.
Изменения схемы
Изменения схемы отсутствуют.
Обновления API 41.4.0
Обновления API XML 41.4.0
При создании запланированных event-совещаний Webex Events может использоваться по умолчанию на уровне веб-сайта при тоновом сигнале входа и выхода
XMLAPI соответствует существующей новой логике для управления тоновым сигналом входа и выхода. Управление всеми тоновыми сигналами для Webex Events осуществлялось различными настройками в службе администрирования веб-сайта. В GetSite
XMLAPI возвращает дополнительное поле entryExitToneEC
, чтобы указать значение. Первоначально, когда администратор сайта устанавливал тональный сигнал по умолчанию, при создании event-совещания этот параметр не использовался с помощью XMLAPI по умолчанию.
Затронутые API
XML API: GetSite возвращает один новый элемент entryExitToneEC
для указания значения.
XML API: Бизнес-логика CreateEvent, SetEvent, GetEvent back end считывает значение entryExitToneEC
.
Изменения схемы
API XML: Пример ответа GetSite:
true
ANNOUNCEMENT AME
NOTONE
true
НЕТ
true
false
Затронутые API:
-
GetSite
-
CreateEvent
-
SetEvent
-
GetEvent
XMLAPI просто возвращает подробную информацию о крупном event-совещании (Webex Event 2.0)
-
Если совещание Webex – это крупное event-совещание или веб-трансляция,
GetSessionInfo
возвращает определенную подробную информацию, включая пароль совещания, числовой пароль совещания, пароль члена команды-организатора и числовой пароль члена команды-организатора (схема не будет изменена). -
XMLAPI не поддерживает создание и редактирование какого-либо крупного event-совещания или функции веб-трансляции, поэтому
CreateMeeting
иSetMeeting
возвращают новое исключение (110064. Тип сеанса event-совещания и веб-трансляции не поддерживается) для большого ebent-совещания или веб-трансляции.
Затронутые API
Имя API |
Описание |
Замечание |
---|---|---|
|
Если совещание Webex – это крупное event-совещание или веб-трансляция, |
Схема не будет изменена. |
|
Если пользователь пытается использовать api |
Поведение изменено. |
Обновления API 41.3.0
Обновления API XML 41.3.0
Новые изменения в API XML поддерживают функцию Webex Events 2.0.
Затронутые API
Оба API: GetSessionInfo и GetMeeting return элементы enableEvent
и enableWebniar
тоже.
Название элемента |
Описание |
---|---|
enableEvent |
Поддержка EC 2.0 на совещании Webex |
enableWebniar |
Поддержка вебинара на совещании Webex |
Поддержка XMLAPI возвращает более двух элементов для EC 2.0. Текущий выпуск API XML не поддерживает планирование и устанавку совещания EC2.0.
Изменения схемы
GetSessionInfo
возвращает элементы enableEvent
и enableWebniar
для EC 2.0.
GetMeeting
возвращает элементы enableEvent
и enableWebniar
для EC 2.0.
Пример ответа:
Ответ GetSessionInfo
:
PUBLIC
false
true
false
false
false
false
true
Ответ GetMeeting
:
false
true
true
true
false
false
true
Новые изменения в XMLAPI поддерживают функцию холла перед совещанием
Затронутые API
XML API: GetSite
, LstSummarySession
, GetSessionInfo
, и GetMeeting
будет отвечать на новый элемент enablePreMeetingLobby
для холла перед совещанием.
Изменения схемы
XML API: GetSite
возвращает элемент enablePreMeetingLobby
для холла перед совещанием.
XML API: LstSummarySession
возвращает элемент enablePreMeetingLobby
для холла перед совещанием.
XML API: GetSessionInfo
возвращает элемент enablePreMeetingLobby
для холла перед совещанием.
XML API: GetMeeting
возвращает элемент enablePreMeetingLobby
для холла перед совещанием.
Пример ответа:
Ответ GetSite
:
false
false
false
true
true
true
true
false
true
true
Ответ LstSummarySession
:
false
true
0
false
false
false
true
Ответ GetSessionInfo
:
PUBLIC
false
true
false
false
false
false
true
Ответ GetMeeting
:
false
true
true
true
false
false
true
Изменение поведения информации об ответах API XML GetSite
раскрывает
Затронутые API
XML API: Ответ GetSite
только ниже элементов для учетной записи администратора, которые включают роли: SiteAdmin
, RO_SiteAdmin
и UserAdmin
.
<ns1:activeUserCount>...</ns1:activeUserCount>
<ns1:activeCETHost>...</ns1:activeCETHost>
<ns1:auoActiveUserCount>
<ns1:MCActiveUserCount>...</ns1:MCActiveUserCount>
<ns1:ECActiveUserCount>
<ns1:TCActiveUserCount>
<ns1:SCActiveUserCount>...</ns1:SCActiveUserCount>...</ns1:SCActiveUserCount>...</ns1:SCActiveUserCount>...</ns1:SCActiveUserCount>...</ns1:SCActiveUser
Поведение изменено
Разрешить только роли администратора иметь данные лицензий ответаGetSite
. Организатор или посетитель не получат данные лицензии в ответе GetSite
.
Ниже приведены API. Пример ответа GetSite
для siteadmin
или только для ready-only siteadmin
или user-management admin:
Обновления API 41.2.0
Обновления API XML 41.2.0
Если веб-сайт поддерживает телефонию Webex, для API XML требуется поддержка параметра "Передача голоса по IP для CMR гибридного типа"
Затронутые API
-
GetSite
возвращает новый элементIsWebexTelephony
в ответе. -
CreateUser
иSetUser
могут обновить элементcmrHybridVoip
, еслиIsWebexTelephony
соответствует действительности наряду с другими условиями.IsTSPUsingTelephonyAPI
больше не имеет значения.
Изменения схемы
API XML: Ответ GetSite
возвращает дополнительный элемент IsWebexTelephony
Ответ GetSite
включает этот новый элемент:
true
false
Номер персонального совещания
Код доступа посетителя
Код доступа организатора
Идентификатор посетителя
....
LstSummarySession
поддерживает EC2.0
Будут также затронуты API XML
LstSummarySession
вернет два новых элемента для поддержки EC 2.0
Название элемента |
Описание |
---|---|
enableEvent |
Поддержка EC 2.0 на совещании Webex |
enableWebniar |
Поддержка вебинара на совещании Webex |
Изменения схемы
API XML: LstSummarySession
: Добавьте элементы <enableEvent
> и <enableWebniar
>
Ответ API XML: LstSummarySession
Ответ для EC 2.0
true
0
false
true
true
API XML поддерживает возврат параметра пользователя веб-сайта Webex-voice-assistant
для интеграции MCT
Затронутые API
GetUser
возвращает новый элемент webexAssistantEnabled
(истина или ложь) в ответе.
Изменения схемы
getUserResponse
:
Пример ответа
Обновления API 41.1.0
В схеме API XML 41.1 нет изменений.