Cisco Webex Meetings API アップデートの概要 (API 41)

XML API は Webex クラシック サイトが Control Hub 管理サイトに変換された後、既存ユーザーの認証の上位互換性をサポートします

影響を受ける API

Webex クラシック サイトを Control Hub 管理サイトに変換した後、 の 要素の値はメール、以下の詳細と同じである必要があります。

• Webex クラシック サイトで作成された既存ユーザーの場合、古い webExID (例: Jack) と新しい webExID (電子メールと同じもの、Jack@xx.com など) の両方によるログインがサポートされており、この認証の下位互換性はすべての XML API が対象です。

• Control Hub 管理サイトで作成された新規ユーザーの場合、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のメールと同じでなければなりません。

xxxx ---既存のユーザーはwebExクラシックサイトで作成されました。jackまたはjack@xx.com。新規ユーザーはjack@xx.com
を使用する必要があります

影響を与える API: GetUser、SetUser、およびDelUser。

スキーマの変更

API のスキーマは変更されません。

API リクエストと応答の例

GetUser APIリクエストと応答

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またはjack@xx.com。新しいユーザーはjack@xx.com
xxxxまたはまたはまたは




xxxxを使用する必要があります。既存のユーザーはwebExクラシックサイトで作成されました。jackまたはjack@xx.com。新規ユーザーはjack@xx.com




API応答例
を使用する必要があります。以前と同じです

録画ビュー履歴レポート API が強化され、Webex Meetings、Webex Events (新)、Webex Events (クラシック) でサポートされます

影響を受ける API

現在の API:lstrecordaccessHistory およびlstrecordaccessDetailHistory は、Webex Trainings録画ビューのアクセス履歴レポートのみをサポートします。この新しい強化機能では Webex Meetings、Webex Events (新)、Webex Events (クラシック) の録画ビュー アクセス履歴レポートにも対応します。

スキーマの変更

以下の API リクエスト本文の API lstrecordaccessHistory の新しいスキーマをサポートしています。

MeetingCenter
TrainingCenter
EventCenter

詳細

API:lstrecordaccessHistory は、Webex Meetings、Webex Events（新）、Webex Events（クラシック）、および Webex Trainings の録画ビューのアクセス履歴を返すことができます。

• API リクエストで指定されたserviceType がない場合、lstrecordaccessHistory のAPIは、Webex Trainings録画ビューのアクセス履歴のみを返します。

• serviceType がMeetingCenterの場合、lstrecordaccessHistory のAPIはWebex MeetingsとWebex Events（新）の録画ビューのアクセス履歴の両方を返します。

• serviceType がEventCenterの場合、lstrecordaccessHistory のAPIはWebex Events（クラシック）の録画ビューのアクセス履歴を返します。

API:lstrecordaccessDetailHistory は、Webex Meetings、Webex Events（新）、Webex Events（クラシック）、Webex TrainingsのrecordID によって詳細を返すことができます。

API リクエストと応答の例

lstrecordaccessHistory APIのリクエストと応答

<?xml version="1.0" encoding="UTF-8"?>
<serv:メッセージ 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>2021 年 9 月 28 日 23:59:59</viewTimeEnd>
</viewTimeScope>
<listControl>
<startFrom>1</startFrom>
<maximumNum>100</maximumNum>
</listControl>

<orderBy>RECORDID</orderBy>
<orderAD>ASC</orderAD>


<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>

</bodyContent>
</ボディ>


<?xml version="1.0" encoding="UTF-8"?>
<serv:メッセージ 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:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<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>2021/09/24 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>2021/06/10 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>2021/07/05 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:recordID>1XXXXXXX7</history:recordID>
<history:recordName>EC2.0_232423-20210922 0447-1
<history:creationTime>2021/09/22 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>2021/09/24 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>2021/09/24 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>2021/09/24 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:メッセージ 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" encoding="UTF-8"?>
<serv:メッセージ 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:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<serv:bodyContent xsi:type="history:lstrecordaccessDetailHistoryResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<history:viewID>1XXXXXX7</history:viewID>
<history:participantName>Axxxg</history:participantName>
<history:participantEmail>Axxxg@qa.webex.com</history:participantEmail>
<history:accessTime>2021/09/24 13:27:26</history:accessTime>
<history:registered>偽</history:registered>
<history:downloaded>false</history:downloaded>
<history:viewed>true</history:viewed>
<history:timeZoneID>20</history:timeZoneID>


<history:viewID>1XXXXXX7</history:viewID>
<history:participantName>Axxxg</history:participantName>
<history:participantEmail>Axxxg@qa.webex.com</history:participantEmail>
<history:accessTime>2021/09/24 13:27:39</history:accessTime>
<history:registered>偽</history:registered>
<history:downloaded>true</history:downloaded>
<history:viewed>false</history:viewed>
<history:timeZoneID>20</history:timeZoneID>

<history:matchingRecords>
<serv:total>2</serv:total>
<serv:returned>2</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
</serv:bodyContent>

影響を与える API:

• lstrecordaccess履歴

• lstrecordaccess詳細履歴

XMLAPI と Webex ページの間の、許容される Webex Events (クラシック) の説明の最大長の差異を修正します。

影響を受ける API

XML API:CreateEvent とSetEvent のdescription 要素を使用すると、最大10000文字の入力が可能になります。サイズを超えると、新しいエラーコードとメッセージが表示されます。

060068 説明の入力が不正です。10,000 文字を超えて入力できません。

スキーマの変更

スキーマの変更はありません。

API リクエストと応答の例

CreateEvent 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>111111</sessionPassword>
<listing>PRIVATE</listing>
</accessControl>
<metaData>
<sessionName>EC test</sessionName>
<description>.......説明が 10000 文字を超える場合に、説明.......</description>
</metaData>
...


------------------------------------
#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>FAILURE</serv:result>
Illegal 説明は 10000 文字を超えることはできません
PRIMARY
060068

影響を与える API:

• CreateEvent

• SetEvent

XML API：GetUser は freeAccount の新しい要素を返します

影響を受ける API

GetUser は、ユーザーアカウントがFreeAccount であるかFreeAccount であるかを識別する新しい要素を返します。

スキーマの変更

GetUser 応答例

GetUserの応答:
AW
false

3
false

影響を与える API:

GetUser