- ホーム
- /
- 投稿記事
Cisco Webex Meetings API アップデートの概要 (API 40)
スキーマの変更や他のアナウンスなど、Cisco Webex Meetings API に関して必要なすべての重要な情報を検索します。
XML API 41 の詳細については、Cisco Webex Meetings API 更新の概要 (API 41) を参照してください。
XML API 39 および XML API 11 の詳細については、『Cisco Webex Meetings XML API の更新概要 (XML API 39 以前)』を参照してください。
XML API 11 SP9 以前の更新については、「Cisco DevNet」に移動してください。
API 40.12.0 更新
XML API 40.12.0 更新
XML API はプライベート ミーティング タイプに対応します
影響を受ける XML API
-
API を使用できます。プライベート ミーティング タイプで Webex ミーティングをスケジュールまたは更新するには、
CreateMeeting
とSetMeeting
を使用します。 -
Webex Meetings がプライベートミーティングタイプでスケジュールされている場合、
GetSessionInfo
GetMeeting
、LstSummarySession
、LstCalendarSession
から、新しい要素のネーミングがPrivateMeeting
であることが返され、このことがわかります。 -
GetMeetingType
とLstMeetingType
は、Private Meetingsをサポートしているかどうかを示す
という名前の新しい要素を返します。SupportPrivateMeeting
スキーマの変更
XML API:GetMeetingType/LstMeetingType: 要素を追加します。
XML API: LstSummaryセッション
:<isPrivateMeeting>
要素を追加します。
XML API: LstCalendarSession
:<isPrivateMeeting>
要素を追加します。
XML API: GetSessionInfo(セッション情報の取得)
:<isPrivateMeeting>
要素を追加します。
XML API: GetMeeting(取得):<isPrivateMeeting>
要素を追加します。
XML API の要求: CreateMeeting
CreateMeeting とプライベート ミーティング タイプの要求
2020/10/25 13:00:00
45
45
;********
MC_PrivateMeeting_Test
168 //169は、プライベートミーティング
をサポートするサンプルです
XML API の応答:GetSessionInfo
isPrivateMeetingの応答
false
true
true //true: このミーティングはプライベート ミーティングに対応します。false:このミーティングはプライベート ミーティングをサポートしていません。
false
false
true
GetSite API がサイト レベルのミーティング テンプレートを返します
ユーザー ストーリー/タスクの説明
GetSite API がサイト レベルのミーティング テンプレートを返します。これにより、Education Connector と Webex Classrooms は、教師がオンライン セッションをスケジュールする間にこれらのテンプレートを選択することができます。
影響を受ける API
サイト レベルでカスタマイズされたミーティング テンプレートがある場合、GetSite api は、これらのサイト レベルのテンプレートを返します。
要素名 |
説明 |
---|---|
|
サイトレベルのカスタマイズされたミーティング テンプレートの名前 |
|
Webex Meetings、Webex Training、および Webex Events |
スキーマの変更
GetSite(サイト) : 要素を追加します。
応答例
GetSite 応答
3
PRO
MC Meeting Tempalte 1
MeetingCenter
EC Meeting Tempalte 2
EventCenter
TC ミーティングテンプレート 3
TrainingCenter
サイトが CI 統合サイトの場合、XML API SetUser は supportedServices
の要素を変更できません
説明
サイトが Unified Webex Meetings サイトにリンクされている Control Hub である場合、XMLAPI SetUser
は API 要求で「supportedServices
」の変更値に対応していません。
スキーマの変更
API のスキーマ変更はありません。SetUser
。
WEBEX-15436Mtgconfattendeelist
でメールが重複しないように保護を追加する
説明
同じ API リクエストで同じメールを持つ複数の出席者が同じミーティングに追加された場合、最初の出席者だけがこのメールを処理します。
影響を受ける API
-
CreateMeetingAttendee
-
CreateUser
-
SetUser
-
CreateMeeting
-
SetMeeting
-
CreateEvent
-
SetEvent
-
CreateTrainingSession
-
SetTrainingSession
サンプル API
リクエスト
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:メッセージ xmlns:xsi="""""""""http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""http://www.webex.com/schemas/2002/06/service">
<ヘッダー>
<securityContext(セキュリティコンテキスト)>
<siteName>testSite</siteName>
<webExID>testUser</webExID>
<password>パスワード</password>
</securityContext(セキュリティコンテキスト)>
</ヘッダー>
<ボディ>
<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/></head><bodyContent xsi:type="java:com.webex.service.binding.attendee.CreateMeetingAttendee">
<sessionKey>1714904382</sessionKey>
<email>test@webex.com</email>
<name>name1</name>
<出席者>
<email>test@webex.com</email>
<name>name2</name>
<sessionKey>1714904382</sessionKey>
</出席者>
</bodyContent>
</ボディ>
API 40.11.0 更新
XML API 40.11.0 更新
XMLAPI CreateUser は表示名をサポートします
CreateUser
は、機能トグルがEnableDisplayName
を1とした場合にdispalyname
をサポートします。機能のトグルが 1 ではない場合、displayName
は無視されます。
スキーマの変更
CreateUser:
XMLAPI SetUser は displayname をサポートします
SetUser
は、機能トグルがEnableDisplayName
の1の場合、dispalyname
をサポートします。機能のトグルが 1 ではない場合、displayName
は無視されます。
スキーマの変更
SetUser:
XMLAPI GetUser は displayname をサポートします
GetUser
は、機能トグルがEnableDisplayName
の1の場合、dispalyname
をサポートします。機能のトグルが 1 ではない場合、displayName
は無視されます。
DB の displayName
が null で、機能で EnableDisplayName
が 1 にトグルされている場合、displayName
はアジア文字以外に対しては firstName+」 "+lastName"
、アジア文字に対しては firstName+lastName
になります。
スキーマの変更
GetUserResponse:
CMR Hybrid Voip のための XMLAPI ユーザー レベル コントロール
cmrHybridVoip
設定は、EnableCMRHybridVoIP
のユーザー レベル設定を設定し、取得するために使用されます。
スキーマの変更
GetUser 応答:
CreateUser 要求:
SetUser 要求:
API 40.10.0 更新
XML API 40.10.0 更新
API リクエストと応答でのミーティング UUID のXML API サポート
サンプル XML API:GetSessionInfo
リクエスト:
<?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">
<header>
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
or
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
応答:
<?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:ep="""http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet=""http://www.webex.com/schemas/2002/06/service/meeting">
<serv:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>いいえ_進捗状況</ep:ステータス>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...。
...。
</serv:bodyContent>
影響を受ける API:
-
CreateMeetingAttendee
-
DelMeetingAttendee
-
RegisterMeetingAttendee
-
CreateTeleconferenceSession
-
SetTeleconferenceSession
-
CreateTeleconferenceSession
-
CreateTrainingSession
-
SetTrainingSession
-
GetTrainingSession
-
DelTrainingSession
-
CreateEvent
-
SetEvent
-
DelEvent
XMLAPI は、サイト管理構成のための追加要素を返して、画面キャプチャを無効にします。
要件は、Goldman Sachs のように、PenTest
のバグと顧客の両方のセキュリティから提供されます。エンドユーザーが Meetings アプリで画面キャプチャを行うことを許可しません。他の多くの顧客はこの機能を希望しています。これにより画面取り込みが可能になります。また、エデュケーション ユーザーも画面取り込みを許可したいと考えています。そのため、サイト管理者の設定が行われ、XMLAPI は、これを サポートするために、GetSite
の応答に追加のフィールド EnableMobileScreenCapture
を返します。
GetSite 要求のサンプル
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<header>
<securityContext>
<siteName>xxxx</siteName>
<webExID>Test</webExID>
<password>xxxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.site.GetSite" />
</body>
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:メッセージ 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:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns1:siteInstance>
...。
<ns1:securityOptions>
...。
...。
<ns1:EnableMobileScreenCapture>false</ns1:EnableMobileScreenCapture>
...。
</ns1:securityOptions>
...。
</ns1:siteInstance>
</serv:bodyContent>
Affected API
GetSite
XMLAPI のサポート MEET-269 PIN なしの参加の改善
XMLAPI 新しいオプションの追加 自分の組織内のビデオ会議システムは、 パーソナル会議室のミーティングおよび MC ミーティングのプロンプトなしでミーティングを開始したり参加することができます。
-
createUser/setUser/getUser
personalMeetingRoomに新しいノードdeviceCanStartMyPMR
を追加します
。 -
createMeeting/setMeeting/getMeeting
スケジュールに新しいノードdeviceCanStartMeeting
を追加します。
パーソナル会議室のミーティングの Webex UI のオプション:
スキーマの変更
CreateUser:
SetUser:
getUserResponse:
CreateMeeting:
setMeeting:
getMeetingResponse:
API 40.9.0 更新
XML API 40.9.0 更新
ミーティング UUID 要求と応答のXML API サポート
meetingKey
または sessionKey
をサポートするときはいつでも、API 要求と応答に meeting UUID を追加しました。
サンプル XML API:GetSessionInfo
リクエスト:
<?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">
<header>
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
or
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
応答:
<?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:ep="""http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet=""http://www.webex.com/schemas/2002/06/service/meeting">
<serv:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>いいえ_進捗状況</ep:ステータス>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...。
...。
</serv:bodyContent>
影響を受ける API:
-
GetEnrollmentInfo
-
LstsummaryTrainingSession
-
LstScheduledTests
-
LstScheduledTests
-
LstScheduledTests
-
GetTestInformation
-
UploadEventImage
-
SendInvitationEmail
-
CreateSupportSession
-
LstmeetingusagePreliminaryHistory
-
LstmeetingattendeePreliminaryHistory
-
LsteventsessionPreliminaryHistory
-
LsteventattendeePreliminaryHistory
-
LstTrainingPollResultsHistory
Webex ミーティングには、ユーザーがミーティングへの参加を待つためのロックされたミーティングロビーがあります
feature(ConsistentLockedLobby
) のトグルをオンにしたときに、XML API をスケジュールし、ロックされたロビーをサポートするために MC ミーティングを編集します。
スキーマの変更
3つの新しい要素 (externalAttendeeSecurity
、 autolock
、 autoLockWaitTime
) を CreateMeeting、SetMeeting、および GetMeeting API に追加しました。
要素 |
説明 |
---|---|
|
ミーティングがロック解除されている場合、3 つの外部のユーザー セキュリティ項目を選択することができます。
|
|
ミーティングを自動的にロックするかどうかを指定します。 その通り: ミーティング開始から # 分後にを自動的にロックします いいえ: ミーティング開始後にミーティングが自動的にロックされない |
|
ミーティング開始後に自動的にミーティングをロックする時間 (分) (0,5,10,15,20) |
要求と応答のサンプル
CreateMeeting の要求:
...
...
false
AllowJoinWithLobby
true
10
...
SetMeeting の要求:
2###1###01
...
...
false
AllowJoinWithLobby
true
10
...
GetMeetingの応答
:
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:メッセージ xmlns:serv=""http://www.webex.com/schemas/2002/06/service" xmlns:com="""http://www.webex.com/schemas/2002/06/common"
xmlns:meet=""http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att=""http://www.webex.com/schemas/2002/06/service/attendee">
<serv:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<serv:bodyContent xsi:type="meet:getMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...。
<meet:attendeeOptions>
...。
<meet:joinRequiresAccount>false</meet:joinRequiresAccount>
<meet:externalAttendeeSecurity>参加を許可</meet:externalAttendeeSecurity>
<meet:autoLock>true</meet:autoLock>
<meet:autoLockWaitTime>10</meet:autoLockWaitTime>
</meet:attendeeOptions>
...。
</serv:メッセージ>
影響を受ける API:
-
CreateMeeting
-
SetMeeting
-
GetMeeting
強化GetSessionInfo
APIにより、進行中のセッションで参加者のステータスを返す
GetSessionInfo
の応答に 2 つの新しい要素 (hashostinmeeting
、hasAttendeeInMeeting
) を追加 しました。ミーティングが進行中のミーティングの場合、これらの 2 つの要素が返されます。
要素 |
説明 |
---|---|
|
主催者が進行中のミーティングに参加しているかどうかを指定します。 その通り: 主催者が進行中のミーティングに参加しています。 偽/ヌル: 主催者が進行中のミーティングに参加していないか、またはミーティングが進行中ではありません。 |
|
出席者/主催者が進行中のミーティングに参加しているかどうかを指定します。 その通り: 進行中のミーティングに参加している出席者または主催者がいます。 偽/ヌル: 進行中のミーティングに参加している出席者または主催者がいいないか、またはミーティングが進行中ではありません。 |
API 応答サンプル:
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:メッセージ xmlns:serv=""http://www.webex.com/schemas/2002/06/service" xmlns:com="""http://www.webex.com/schemas/2002/06/common"
xmlns:meet=""http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att=""http://www.webex.com/schemas/2002/06/service/attendee">
<serv:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<serv:bodyContent xsi:type="meet:getMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...。
<ep:status>インプログレス</ep:status>
<ep:hasHostInMeeting>true</ep:hasHostInMeeting>
<ep:hasAttendeeInMeeting>true</ep:hasAttendeeInMeeting>
...。
</serv:メッセージ>
影響を受ける API:
GetSessionInfo
API GetUserCard には承認が必要です。
セキュリティ強化 XML API GetUserCard
は、 ユーザーの情報を取得するために承認が必要です。
影響を受ける API:
GetUserCard
API 40.8.0 更新
XML API 40.8.0 更新
GetSessionInfo
応答の強化
ミーティングから招待または承認されていない場合は、XML API へのコール:GetSessionInfo
は要素を返しません。confName、startDate、duration、timeZone、meetingLink、sipURL、displayMeetingUrl
を API 応答ボディに表示します。
ミーティングの API 応答の例:
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>いいえ_進捗状況</ep:ステータス>
<ep:sessionkey>1####2###4</ep:sessionkey>
<ep:accessControl>
<ep:listStatus>非公開</ep:listStatus>
<ep:registration>false</ep:registration>
<ep:passwordReq>true</ep:passwordReq>
<ep:isRegisterIDRequired>false</ep:isRegisterIDRequired>
</ep:accessControl>
<ep:metaData>
<ep:serviceType>MeetingCenter</ep:serviceType>
</ep:metaData>
<ep:attendeeOptions>
<ep:joinRequiresAccount>false</ep:joinRequiresAccount>
</ep:attendeeOptions>
<ep:isAllowJBH>true</ep:isAllowJBH>
<ep:isCETMeeting>true</ep:isCETMeeting>
<ep:isPersonalMeetingRoom>false</ep:isPersonalMeetingRoom>
トレーニング/イベントの API 応答の例:
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>いいえ_進捗状況</ep:ステータス>
<ep:sessionkey>1####5###9</ep:sessionkey>
<ep:listStatus>非公開</ep:listStatus>
<ep:registration>true</ep:registration>
https://sitename.webex.com/tc3300/trainingcenter/register/registerSession.do?siteurl=sitename&confID=16###92######61</ep:registrationURL>
<ep:passwordReq>true</ep:passwordReq>
<ep:registrationURLForMobile>https://sitename.webex.com/tc3300/trainingcenter/meeting/sessionInfoMobile.do?siteurl=sitename&confID=16###92######61</ep:registrationURLForMobile>
<ep:joinStatus>INVITE/REGISTER/REJECT</ep:joinStatus>
<ep:isRegisterIDRequired>false</ep:isRegisterIDRequired>
</ep:accessControl>
<ep:metaData>
<ep:serviceType>TrainingCenter</ep:serviceType>
</ep:metaData>
<ep:attendeeOptions>
<ep:joinRequiresAccount>false</ep:joinRequiresAccount>
</ep:attendeeOptions>
<ep:isAllowJBH>true</ep:isAllowJBH>
<ep:isCETMeeting>true</ep:isCETMeeting>
<ep:isPersonalMeetingRoom>false</ep:isPersonalMeetingRoom>
影響を受ける API:
-
GetSessionInfo
GetSessionInfo、GetUserCard
セキュリティの強化
XML API GetSessionInfo
および GetUserCard
でセキュリティを強化しました。1 時間以内にデータのエラーが見つからずにコールが制限値に達した場合、ユーザーが今後 2 時間以内にこれらの 2 つの API にアクセスすることをブロックします。
エラーステータスの応答は「403 Forbidden」です。
影響を受けるAPI:-
GetSessionInfo
-
GetUserCard
API リクエストおよび応答サポートでのmeetingUUID
meetingKey/sessionKey
をサポートするときに、API 要求と応答に meetingUUID を追加しました。
GetSessionInfo
リクエスト:
<?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">
<header>
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
or
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
応答:
<?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:ep="""http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet=""http://www.webex.com/schemas/2002/06/service/meeting">
<serv:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>いいえ_進捗状況</ep:ステータス>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...。
...。
</serv:bodyContent>
影響を受ける API:
-
LstOpenSession
-
GetEnrollmentInfo
-
LstsummaryMeeting
-
LstScheduledTests
-
GetEvent
-
LstsummaryEvent
-
LstmeetingusageHistory
-
LsttrainingsessionHistory
-
LsteventsessionHistory
-
LstsupportsessionHistory
-
DelSession
XML API 対応のエデュケーション サイト テンプレート (EDU セッション タイプ)
サイトが Education Instructor (EDU) セッションタイプを有効にすると、XML API は EDU ミーティング テンプレートを使ってミーティングをスケジュールすることをサポートすることができます。
影響を受ける API:
-
CreateMeeting
-
SetMeeting
-
CreateEvent
-
SetEvent
-
CreateTrainingSession
-
SetTrainingSession
XML API CreateMeetingAttendee
および RegisterMeetingAttendee
サポート
CreateMeetingAttendee
と rRegisterMeetingAttendee
が、Webex Meetings 登録に必要な出席者の登録フォームを確認することができます。
このタスクには新しい例外があります。
例外番号 |
例外のメッセージ |
---|---|
040014 |
必須フィールドがありません (登録フォーム): ... |
たとえば、出席者の Webex Meetings 登録の必須フィールドとして、[役職] および [会社名] を選択した場合、2 つの API を呼び出すときに、「役職」と「会社名」の値を入力することが必要になります。 CreateMeetingAttendee
とRegisterMeetingAttendee
。
RegisterMeetingAttendee
のリクエスト:
FirstNameb ラストネーム
FirstNameb
ラストネーム
エンジニア //職名
Cisco1234 //会社名
...。
****@*****.com
ビジター
true
出席者
同意する
true
1####4####1
CreateMeetingAttendee
リクエスト:
FirstNameA LastNameA
FirstNameA
LastNameA
Engineer //Job Title
Cisco1234 //Company Name
...
;*****@*****.com
VISITOR
true
ATTENDEE
ACCEPT
true
1###4####1
040014 応答の除外
例:
<?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:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:result>FAILURE</serv:result>
必須フィールドがありません(登録フォーム): title,company
PRIMARY
040014
title,company
影響を受ける API:
-
CreateMeetingAttendee
-
RegisterMeetingAttendee
XML API メール検証の強化
XML API はメールで空白文字を許可しないため、Webex Meetings ページの動作に合わせてメール検証を強化しました。
影響を受ける API:
-
CreateMeetingAttendee
-
CreateEvent
-
SetEvent
-
CreateContact
-
SetContact
-
SetRecordingInfo
-
CreateMeetingAttendee
-
CreateTrainingSession
-
SetTrainingSession
-
CreateUser
-
SetUser
-
CreateMeeting
-
SetMeeting
-
RegisterMeetingAttendee
API 40.7.0 更新
XML API 40.7.0 更新
meetingUUID
サポート
meetingKey または sessionKey をサポートするときに、API 要求と応答に meetingUUID
を追加しました。
GetSessionInfo
リクエストの例:
<?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">
<header>
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
or
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
GetSessionInfo
リクエストの例:
<?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">
<header>
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
or
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
GetSessionInfo
応答の例:
<?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:ep="""http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet=""http://www.webex.com/schemas/2002/06/service/meeting">
<serv:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>いいえ_進捗状況</ep:ステータス>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...。
...。
</serv:bodyContent>
影響を受けるAPI:
-
LsttrainingattendeeHistory
-
LsttrainingattendeeHistory
-
LsteventattendeeHistory
-
LstsupportattendeeHistory
CreateUser
APIウェルカムメールによる4つの新しい言語のサポート
XMLAPI ようこそ html メールは次の 4 つの新しい言語をサポートしています。
-
チェコ語 (languageID = 19)
-
ポーランド語 (languageID = 20)
-
ハンガリー語 (languageID = 21)
-
ルーマニア語 (languageID = 22)
XMLAPI は CreateUser
リクエストの言語または languageID に従って、ウェルカム メールを送信します。
CreateUser
を使ってHtmlウェルカムメールを送信例(チェコ語):
<?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(セキュリティコンテキスト)>
<siteName>xxx</siteName>
<webExID>テスト</webExID>
<password>xxx</password>
</securityContext(セキュリティコンテキスト)>
</ヘッダー>
<ボディ>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<firstName>テスト</firstName>
<lastName>ユーザー</lastName>
<webExId>テストユーザー</webExId>
<password>xxxxxx</password>
<email>testuser@test.com</email>
<特権>
<host>true</host>
</特権>
<languageID>19</languageID>
または
<language>チェコ語</language>
<active>アクティブ</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>true</isHTMLEmail>
</bodyContent>
</bodyContent>
</ボディ>
API 40.6.1、40.4.9 更新
XML API 40.6.1、40.4.9 更新
CreateMeeting/SetMeeting
サポート
Webex ミーティングをスケジュールするときには、XML API CreateMeeting/SetMeeting
を使えば、出席者の登録フォームの必須または必須以外フィールドのオンオフを切り替えることができます。
以下は、ユーザーのウェブ ページからのサンプルのミーティング スケジュールで、出席者登録フォームの [Job Title]、[Company Name]、[City]、[State] といった必須のフィールドをチェックすることができます。
次に示すのは、ページ フィールドと XML API の要素のマッピングです。
ページ フィールド | XMLAPI 要素 |
---|---|
職種 | <title> |
会社名 | <company> |
所在地 1 | <address1> |
所在地 2 | <address2> |
市区町村 | <city> |
状況 | <state> |
郵便番号 | <postalCode> |
国/地域 | <country> |
オフィス電話番号 | <phone> |
FAX | <fax> |
変更されたスキーマ:CreateMeetingに「registrationForm」要素を追加する
変更されたスキーマ:SetMeetingに「registrationForm」要素を追加する
変更されたスキーマ:GetMeetingに「registrationForm」要素を追加する
CreateMeeting
リクエストの例:
パスワード
true
true
false
true
true
false
false
true
true
false
false
フォルス
false
SetMeeting
リクエストの例:
1015045339
会議名
3
true
true
true
true
true
false
false
true
true
false
false
フォルス
false
GetMeeting
応答の例:
1234567890@sitename.webex.com
1234567890@sitename.webex.com
false
true
true
false
false
true
true
false
false
false
影響を受けるAPI:
-
CreateMeeting
-
SetMeeting
-
GetMeeting
-
DelMeeting
E2EE ミーティング タイプは PMR ミーティングをサポートしていません
API を使用して通話中に PMR を有効にする場合:CreateUser/SetUser/GetUser/GetMe
でE2EEミーティングタイプのみが利用可能で、次のエラーメッセージに応答します。「110063 PMRを有効にするには、E2EE以外のミーティングタイプが少なくとも1つ必要です。」
影響を受けるAPI:
-
CreateUser
-
SetUser
-
GetUser
-
GetMe
API 40.6.0 更新
XML API 40.6.0 更新
追加されたユーザー管理役割
ユーザー管理の役割を作成し、次のスキーマ ファイルが変更されました。
変更されたスキーマ:CreateUser
リクエスト:
変更されたスキーマ:SetUser
変更されたスキーマ:GetMe
の応答:
変更されたスキーマ:LstsummaryUser
の応答:
影響を受けるAPI:
-
CreateUser
-
SetUser
-
GetMe
-
LstSummaryUser
CreateUser
リクエストの例:
<?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(セキュリティコンテキスト)>
<siteName>xxx</siteName>
<webExID>サイト管理</webExID>
<password>xxxx</password>
</securityContext(セキュリティコンテキスト)>
</ヘッダー>
<ボディ>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<firstName>xxx</firstName>
<lastName>xxx</lastName>
<webExId>xxx</webExId>
<password>xxx</password>
<email>xxx</email>
<特権>
<umSiteAdmin>true</umSiteAdmin>
<host>false</host>
<siteAdmin>false</siteAdmin>
<labAdmin>false</labAdmin>
<voiceOverIp>フォルス</voiceOverIp>
</特権>
<languageID>3</languageID>
<active>アクティブ</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>true</isHTMLEmail>
</bodyContent>
</ボディ>
APIキーを使用したサポート、GetUserCard
へのアクセス
API キー (生成された JWT トークン) を使用して API にアクセスできるようになりました。このリリースのGetUserCard
これらのページを使用して、1つの API キーの適用と JWT トークンの生成について参照することができます。
GetUserCard
リクエストの例:
POST https://{sitename}.webex.com/WBXService/XMLService
Header:
Content-Type application/json;charset=utf-8
JWTToken ${jwttoken}
Body:
<?xml version="1.0" encoding="UTF-8"?>
<message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2009/05/service">
<header>
<siteName>{sitename}</siteName>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUserCard">
<webExId>{userName}</webExId>
</bodyContent>
</body>
応答例:
<?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:use=""http://www.webex.com/schemas/2002/06/service/user">
<serv:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<serv:bodyContent xsi:type="use:getUserCardResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<use:アバター>
https://xxxx.webex.com/svc3300/svccomponents/html/img/avatar160.png</use:url>
<use:lastModifiedTime>1587493389768</use:lastModifiedTime>
<use:isUploaded>false</use:isUploaded>
</use:アバター>
<use:title>テストのパーソナル会議室</use:title>
<use:personalMeetingRoomURL>https://xxxx.webex.com/meet/Test</use:personalMeetingRoomURL>
<use:accessCode>713289692</use:accessCode>
</use:personalMeetingRoom>
</serv:bodyContent>
APIリクエストと応答でのmeetingUUID
のサポート
meetingKey または sessionKey をサポートするときに、API 要求と応答に meetingUUID
を追加しました。
影響を受けるAPI:
-
LstRecording
-
LstsummarySession
-
GetSesssionInfo
-
GethosturlMeeting
-
GetjoinurlMeeting
-
LstMeetingAttendee
-
CreateMeeting
-
SetMeeting
-
GetMeeting
-
DelMeeting
-
LstCalendarSession
meetingUUID
リクエストの例:
<?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">
<header>
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
or
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
meetingUUID
応答の例:
<?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:ep="""http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet=""http://www.webex.com/schemas/2002/06/service/meeting">
<serv:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>いいえ_進捗状況</ep:ステータス>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...。
...。
</serv:bodyContent>
PMR のミーティング キーは、一時的に非アクティブになったユーザーまたは無効された PMR からは変更されます
一時的に非アクティブ化されたユーザーまたは無効化された PMR が 1 週間以内に再アクティブ化された場合、現在再アクティブ化されたユーザーまたは有効化された PMR のミーティングキーは変更されません。
影響を受けるAPI:
-
SetUser
-
DelUser
LstSummarySession
の強化
API を強化しました:LstSummarySession
リクエストに1つの新しい要素returnScheduledPMR
を持つscheduled-PMRを返します。フィーチャートグル デフォルトはオフになっています。
影響を受けるAPI:
-
LstSummarySession
スキーマの変更:
API LstSummarySession 要求で新しい要素名 returnScheduledPMR
を追加します。
API LstSummarySession 応答で新しい要素名 isScheduledPMR
を追加します。
LstSummarySession
リクエストの例:
<?xml version="1.0" encoding="UTF-8"?>
<serv:メッセージ xmlns:serv=""http://www.webex.com/schemas/2002/06/service" xmlns:xsi="""http://www.w3.org/2001/XMLSchema-instance">
<ヘッダー>
<securityContext(セキュリティコンテキスト)>
<siteName>xxx</siteName>
<webExID>テスト</webExID>
<password>xxx</password>
<partnerID>xxxx</partnerID>
<clientInfo>xxxx</clientInfo>
</securityContext(セキュリティコンテキスト)>
</ヘッダー>
<ボディ>
<bodyContent xsi:type="java:com.webex.service.binding.ep.LstsummarySession">
<listControl>
<startFrom>1</startFrom>
<maximumNum>2</maximumNum>
<listMethod>および</listMethod>
</listControl>
<dateScope>
<startDateStart>2019/11/01 8:0:0</startDateStart>
<startDateEnd>2019/12/01 7:59:59</startDateEnd>
<timeZoneID>4</timeZoneID>
<endDateStart>2019/11/01 8:0:0</endDateStart>
<endDateEnd>2019/12/01 7:59:59</endDateEnd>
</dateScope>
<orderBy>HOSTWEBEXID</orderBy>
<orderAD>ASC</orderAD>
<orderBy>コンファネーム</orderBy>
<orderAD>ASC</orderAD>
<orderBy>スタートタイム</orderBy>
<orderAD>ASC</orderAD>
<serviceType>EventCenter</serviceType>
<serviceType>MeetingCenter</serviceType>
<serviceType>SalesCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>SupportCenter</serviceType>
<returnScheduledPMR>true</returnScheduledPMR>
</bodyContent>
</ボディ>
LstSummarySession
応答の例:
<?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:ep="""http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet=""http://www.webex.com/schemas/2002/06/service/meeting">
<serv:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<serv:bodyContent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ep:lstsummarySessionResponse">
<ep:matchingRecords>
<serv:total>1787</serv:total>
<serv:returned>2</serv:returned>
<serv:startFrom>1</serv:startFrom>
</ep:matchingRecords>
<ep:セッション>
<ep:sessionKey>809914325</ep:sessionKey>
<ep:MeetingUUID>809914325</ep:MeetingUUID>
<ep:confName>チームミーティング</ep:confName>
<ep:sessionType>3</ep:sessionType>
<ep:serviceType>MeetingCenter</ep:serviceType>
<ep:hostWebExID>テスト</ep:hostWebExID>
<ep:hostFirstName>テスト</ep:hostFirstName>
<ep:hostLastName>テスト</ep:hostLastName>
<ep:otherHostWebExID>テスト</ep:otherHostWebExID>
<ep:timeZoneID>2</ep:timeZoneID>
<ep:timeZone>GMT-10:00、ハワイ(ホノルル)</ep:timeZone>
<ep:status>いいえ_進捗状況</ep:ステータス>
<ep:startTime>2019/10/12 00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>パブリック</ep:listStatus>
<ep:hostEmail>Test@webex.com</ep:hostEmail>
<ep:passwordReq>true</ep:passwordReq>
<ep:hostJoined>false</ep:hostJoined>
<ep:participantsJoined>false</ep:participantsJoined>
<ep:confID>141672157056861215</ep:confID>
<ep:registration>false</ep:registration>
<ep:isRecurring>true</ep:isRecurring>
<ep:hostType>1019001</ep:hostType>
<ep:isAudioOnly>false</ep:isAudioOnly>
<ep:isTCSingleRecurrence>false</ep:isTCSingleRecurrence>
<ep:isAllowJBH>false</ep:isAllowJBH>
<ep:isCETMeeting>true</ep:isCETMeeting>
<ep:isException>false</ep:isException>
<ep:isNextUpcomingInstance>false</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:recurrenceId>0</ep:recurrenceId>
<ep:isScheduledPMR>true</ep:isScheduledPMR>
</ep:セッション>
<ep:セッション>
<ep:sessionKey>805660167</ep:sessionKey>
<ep:confName>xmlmc Molly08Console816960001</ep:confName>
<ep:sessionType>3</ep:sessionType>
<ep:serviceType>MeetingCenter</ep:serviceType>
<ep:hostWebExID>Molly08Console81696000</ep:hostWebExID>
<ep:hostFirstName>Molly08Console81696000</ep:hostFirstName>
<ep:hostLastName>Molly08Console81696000</ep:hostLastName>
<ep:otherHostWebExID>Molly08Console81696000</ep:otherHostWebExID>
<ep:timeZoneID>2</ep:timeZoneID>
<ep:timeZone>GMT-10:00、ハワイ(ホノルル)</ep:timeZone>
<ep:status>いいえ_進捗状況</ep:ステータス>
<ep:startTime>2019/10/12 00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>パブリック</ep:listStatus>
<ep:hostEmail>Molly08Console81696000@webex.com</ep:hostEmail>
<ep:passwordReq>true</ep:passwordReq>
<ep:hostJoined>false</ep:hostJoined>
<ep:participantsJoined>false</ep:participantsJoined>
<ep:confID>141672108716459038</ep:confID>
<ep:registration>false</ep:registration>
<ep:isRecurring>true</ep:isRecurring>
<ep:hostType>1019001</ep:hostType>
<ep:isAudioOnly>false</ep:isAudioOnly>
<ep:isTCSingleRecurrence>false</ep:isTCSingleRecurrence>
<ep:isAllowJBH>false</ep:isAllowJBH>
<ep:isCETMeeting>true</ep:isCETMeeting>
<ep:isException>false</ep:isException>
<ep:isNextUpcomingInstance>false</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:recurrenceId>0</ep:recurrenceId>
<ep:isScheduledPMR>true</ep:isScheduledPMR>
</ep:セッション>
</serv:bodyContent>
GetSite
の強化
SupportXMLAPIReturnScheduledPMR
のGetSite応答機能のトグルが追加されました
影響を受けるAPI:
-
GetSite
スキーマの変更:
XML API GetSite
応答の新しい要素:SupportXMLAPIReturnScheduledPMR
GetSite
リクエストの例:
<?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">
<header>
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
<clientInfo>xxx</clientInfo>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.site.GetSite">
</bodyContent>
</body>
GetSite
応答の例:
<?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:ns1="""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""http://www.webex.com/schemas/2002/06/service/site" xmlns:event=""http://www.webex.com/schemas/2002/06/service/event">
<serv:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns1:siteInstance>
<ns1:siteCommonOptions>
...。
<ns1:SupportXMLAPIReturnScheduledPMR>true</ns1:SupportXMLAPIReturnScheduledPMR>
...。
</ns1:siteCommonOptions>
</ns1:siteInstance>
</serv:bodyContent>
API 40.4.8、40.2.9 更新
XML API 40.4.8、40.2.9 更新
XMLAPI でスケジュールされたミーティングを更新する際の新しい応答
顧客が XMLAPI を使用して、ページでスケジュールされたミーティングを更新すると、ミーティングのメール更新で数字のパスワードを送信し、Webex Meetings、Teams、および Events センターに適用します。
これらの API:GetMeeting、GetTrainingSession、GetEvent
およびGetTeleconferenceSession
には、次の新しい要素が応答として追加されます。Webex Meetings、Teams、Events センターのaudioPassword
(数字のパスワード)、 isEnforceAudioPassword
、isEnforceAudioLogin
。
変更されたスキーマ:
影響を受けるAPI:
-
GetMeeting
-
GetTrainingSession
-
GetEvent
-
CreateTeleconferenceSession
GetMeeting
リクエストの例:
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
<securityContext>
<siteName>testSite</siteName>
<webExID>test</webExID>
<password>xxx</password>
<partnerID>xx</partnerID>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.meeting.GetMeeting">
<meetingKey>803328224</meetingKey>
</bodyContent>
</body>
応答例:
<?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:meet=""http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att=""http://www.webex.com/schemas/2002/06/service/attendee">
<serv:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<serv:bodyContent xsi:type="meet:getMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<meet:accessControl>
<meet:listToPublic>false</meet:listToPublic>
<meet:isPublic>false</meet:isPublic>
<meet:meetingPassword>PkzC8tP7kM5</meet:meetingPassword>
<meet:audioPassword>75928877</meet:audioPassword>
<meet:isEnforceAudioPassword>true</meet:isEnforceAudioPassword>
<meet:isEnforceAudioLogin>false</meet:isEnforceAudioLogin>
</meet:accessControl>
...。
...。
</serv:bodyContent>
API 40.4.5、40.2.6 更新
XML API 40.4.5、40.2.6 更新
GetUserCard
とGetSessionInfo
の使用制限
API GetUserCard
とGetSessionInfo
の使用制限を実装しています。使用制限に達すると、「403 forbidden」というエラーメッセージが表示されます。
影響を受けるAPI:
-
GetUserCard
-
GetSessionInfo
API 40.4.4、40.2.5 更新
XML API 40.4.4、40.2.5 更新
BodyContent
番号の制限
各 XML API セクションには、限られた数の BodyContent
が追加されました。API リクエストに BodyContent
を追加しすぎると、次のエラー コードとメッセージが返されます。「000053 リクエストの BodyContent の数は {number} 未満でなければなりません」
影響を受けるAPI:
-
すべての XML API
複数のBodyContent
を使用したXML 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>xxxx</webExID>
<password>xxxx</password>
<siteName>xxx</siteName>
</securityContext(セキュリティコンテキスト)>
</ヘッダー>
<ボディ>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser">
<webExId>xxx</webExId>
</bodyContent>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetSite">
</bodyContent>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>801020403</sessionKey>
</bodyContent>
</ボディ>
API 40.4.3、40.2.4 更新
XML API 40.4.3、40.2.4 更新
CreateUser
の強化
複数言語でようこそメールをサポートするために CreateUser
を強化しました。CreateUser
のリクエストがHTMLEmail
になりました
影響を受けるAPI:
-
CreateUser
CreateUser
リクエストの例:
<?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>管理者</webExID>
<password>xxxx</password>
<siteName>xxx</siteName>
</securityContext(セキュリティコンテキスト)>
</ヘッダー>
<ボディ>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<firstName>xxx</firstName>
<lastName>xxx</lastName>
<webExId>xxx</webExId>
<password>xxx</password>
<email>xxx</email>
<特権>
<host>true</host>
<siteAdmin>false</siteAdmin>
<labAdmin>false</labAdmin>
<voiceOverIp>フォルス</voiceOverIp>
</特権>
<languageID>3</languageID>
<active>アクティブ</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>true</isHTMLEmail>
</bodyContent>
</ボディ>
API 40.4.0 更新
XML API 40.4.0 更新
XML API でメールを変更する際のメール検証を強制する
サイト管理者により、 ユーザーが Webex サイト管理でメール アドレスを更新するための確認が有効にされた後:
-
サイト管理者以外のアカウントが、メール アドレスを変更するために
SetUser API
を呼び出す場合、現在のメールは新しいメールが確認されるまで残っています。アカウント変更の確認メールが、「Webex アカウント変更確認」と共に新しいメールアドレスに送信されます。確認のためのメールのリンクをクリックすると、新しいメール アドレスがすぐにリンクされます。サイト管理者でない人がメール検証プロセスを完了
せずに
何度も SetUser API を呼び出すと、現在のメールが保存され、最新の 新しいメールが確認する必要があります。 -
サイト管理者アカウントが、メール アドレスを変更するために
SetUser API
を呼び出す場合、新しいメールのプロセスがトリガーされません。新しいメールは、主催者または出席者のアカウントにすぐにリンクされます。
影響を受けるAPI:
-
SetUser
GetEnrollmentInfo
のタイムアウトと接続のリセット
GetEnrollmentInfo
API は、現在、大規模なパフォーマンスに影響を与えるドメイン ネーム システム上の IP アドレスを参照しています。この処理を簡素化することを予定しており、 <domain>
フィールドには空の応答があります。
影響を受けるAPI:
-
GetEnrollmentInfo
GetEnrollmentInfo
リクエストの例:
<?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">
<header>
<securityContext>
<siteName>sqdemo6</siteName>
<webExID>xxx</webExID>
<password>xxxx</password>
<partnerID>webexpartner</partnerID>
</securityContext>
</header>
<body>
<bodyContent
xsi:type="java:com.webex.service.binding.attendee.GetEnrollmentInfo">
<sessionKey>716773566</sessionKey>
</bodyContent>
GetEnrollmentInfo
応答の例:
<?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:att=""http://www.webex.com/schemas/2002/06/service/attendee">
<serv:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<serv:bodyContent xsi:type="att:getEnrollmentInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<att:セッション>
<att:confID>154279066999981548</att:confID>
<att:出席者>
<att:attendeeID>3191792</att:attendeeID>
<att:enrollFields>
<att:defaultFields>
<att:firstName>アレックス</att:firstName>
<att:lastName>ヤン</att:lastName>
<att:email>omega.alex.yang@gmail.com</att:email>
<att:company></att:company>
<att:phoneNum></att:phoneNum>
<att:title></att:title>
<att:receiveInfo>false</att:receiveInfo>
<att:address1></att:address1>
<att:address2></att:address2>
<att:city></att:city>
<att:state></att:state>
<att:zipcode></att:zipcode>
<att:country></att:country>
<att:leadSourceID></att:leadSourceID>
<att:leadScore>0.0</att:leadScore>
</att:defaultFields>
<att:customFields/>
</att:enrollFields>
<att:domain> </att:domain>
<att:ipAddress>10.35.240.53</att:ipAddress>
<att:submitTime>2020/02/27 22:03:57</att:submitTime>
<att:status>承認済み</att:status>
</att:出席者>
<att:出席者>
<att:attendeeID>3191797</att:attendeeID>
<att:enrollFields>
<att:defaultFields>
<att:firstName>AlexKKK</att:firstName>
<att:lastName>テスト</att:lastName>
<att:email>achillesyang@hotmail.com</att:email>
<att:company></att:company>
<att:phoneNum></att:phoneNum>
<att:title></att:title>
<att:receiveInfo>false</att:receiveInfo>
<att:address1></att:address1>
<att:address2></att:address2>
<att:city></att:city>
<att:state></att:state>
<att:zipcode></att:zipcode>
<att:country></att:country>
<att:leadSourceID></att:leadSourceID>
<att:leadScore>0.0</att:leadScore>
</att:defaultFields>
<att:customFields/>
</att:enrollFields>
<att:domain> </att:domain>
<att:ipAddress>10.154.181.15</att:ipAddress>
<att:submitTime>2020/02/27 22:07:38</att:submitTime>
<att:status>承認済み</att:status>
</att:出席者>
<att:matchingRecords>
<serv:total>2</serv:total>
<serv:returned>2</serv:returned>
<serv:startFrom>1</serv:startFrom>
</att:matchingRecords>
<att:sessionKey>716773566</att:sessionKey>
</att:セッション>
</serv:bodyContent>
API 40.2.0 更新
XML API 40.2.0 更新
LstSummarySession
への匿名アクセスを削除
セキュリティ強化として、LstSummarySession API
への匿名アクセスのサポートを停止しています。Webex Meetings が匿名で API にアクセスすると、「000015 申し訳ありません、レコードが見つかりません」というエラーコードとメッセージが返されます。
影響を受けるAPI:
-
LstSummarySession
LstSummarySession
リクエストの例:
<?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">
<header>
<securityContext>
<siteName>sitename1</siteName>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.LstsummarySession">
<sessionKey>211894651</sessionKey>
</bodyContent>
</body>
LstSummarySession
応答の例:
<?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:ep="http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:response>
<serv:result>FAILURE</serv:result>
<serv:reason>申し訳ありません、レコードが見つかりません</serv:reason>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
<serv:exceptionID>000015</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
CreateMeeting
およびSetMeeting
のセキュリティ強化
この変更は XML API 40.2.0 で行われましたが、顧客からのフィードバックを受信した後に、その説明が編集されました。
セキュリティ強化として、 CreateMeeting
と SetMeeting
API を更新して、ユーザーがすでに過ぎた時間にミーティングの開始時刻をスケジュールすることができないようにしました。試行すると、API は「060016 セッションの開始時刻は現在の時刻より遅れている必要があります」というエラーメッセージを表示します。ユーザーがインスタント ミーティングをスケジュールする必要がある場合、ミーティングの開始時刻は現在の時刻の5分後に設定することをお勧めします。
影響を受けるAPI:
-
CreateMeeting
-
SetMeeting
API 40.1.2 更新
XML API 40.1.2 更新
ミーティングをスケジュールすると、パスワードが指定されていない場合は自動的に作成します。
CreateMeeting
、 CreateEvent
、 CreateTrainingSession
、および CREATETELECONFERENCESESSION を強化して、 API 応答の本文にパスワードを含めます。
デフォルトでは、 すべてのミーティング/イベント/セッションは、[パスワード] 設定が有効になっている必要があり ます。このシナリオでは、API リクエストにパスワードが含まれていない場合、XML API サーバーからパスワードが自動的に生成されるようになりました。
すべての ミーティング/イベント/セッションの 設定が無効になっていて、API リクエストにパスワードが含まれていない場合、XML API サーバーからパスワードは生成されません。
API リクエストにパスワードが含まれている場合、応答には、すべてのミーティング/イベント/セッションにパスワード設定を有効または無効にする必要があるかどうかに関係なく、そのパスワードが含まれます。
影響を受けるAPI:
-
CreateMeeting
-
CreateEvent
-
CreateTrainingSession
-
CreateTeleconferenceSession
CreateMeeting
応答には、meetingPassword
要素が追加され ました。
CreateMeeting
リクエストの例:
<?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(セキュリティコンテキスト)>
<siteName>siteName1</siteName>
<webExID>ユーザーID</webExID>
<password>*****</password>
<partnerID>webexpartner</partnerID>
</securityContext(セキュリティコンテキスト)>
</ヘッダー>
<ボディ>
<bodyContent xsi:type="java:com.webex.service.binding.meeting.CreateMeeting">
<metaData>
<confName>Test_Aさんuto_G(グラム)enerated_mtg_pwd</confName>
<meetingType>3</meetingType>
</metaData>
<スケジュール>
<startDate>2020年10月28日 17:35:00</startDate>
</スケジュール>
</bodyContent>
</ボディ>
CreateMeeting
応答の例:
<?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:meet=""http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att=""http://www.webex.com/schemas/2002/06/service/attendee">
<serv:ヘッダー>
<serv:レスポンス>
<serv:result>成功</serv:result>
<serv:gsbStatus>プライマリ</serv:gsbStatus>
</serv:レスポンス>
</serv:header>
<serv:ボディ>
<serv:bodyContent xsi:type="meet:createMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<meet:meetingkey>806745263</meet:meetingkey>
<meet:meetingPassword>UzXJuzUD428</meet:meetingPassword>
<meet:iCalendarURL>
https://hmwds6.qa.webex.com/hmwds6/j.php?MTID=md225d5935256319ef21b71dd8ebd0640</serv:host>
https://hmwds6.qa.webex.com/hmwds6/j.php?MTID=m26bf5e25ca587d32302fb29951b92e15</serv:attendee>
</meet:iCalendarURL>
<meet:guestToken>cfc7f3246d4862f1bb69b803e8615b7a</meet:guestToken>
</serv:bodyContent>
CreateEvent
応答には、eventPassword
要素が追加され ました。
CreateTrainingSession
および CreateTeleconferenceSession
応答には、sessionPassword
要素が含まれるようになりました。
API 40.1.0 更新
XML API 40.1.0 更新
GetSessionInfo
の強化
新しい要素を GetSessionInfo
API に追加しました。API がモバイル デバイスの情報を返します。
影響を受けるAPI:
-
GetSessionInfo
GetSessionInfo
リクエストの更新:
要求例:
<?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(セキュリティコンテキスト)>
<siteName>sqdemo11</siteName>
<webExID>サイト管理者</webExID>
<password>P@ss1234</password>
</securityContext(セキュリティコンテキスト)>
</ヘッダー>
<ボディ>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>713707633</sessionKey>
https://go.webex.com/join/dongchen</pmrUrl>
<sipUrl>dongchen@go.webex.com または 123456789_go@webex.com または 123456789@go.webex.com</sipUrl>
https://go.webex.com/go/j.php?MTID=m814c6a483d4b5052d539f88d67acbad6</meetingLink>
<meetingUuid>34567323456787654323456787654</meetingUuid>
</bodyContent>
</ボディ>
LstAccessAnywhereHistory
の強化
Webex Access Anywhere レポートの情報を使用して応答するために、新しい API である lstAccessAnywhereHistory
を追加しました。
影響を受けるAPI:
-
LstAccessAnywhereHistory
LstAccessAnywhereHistory
リクエストの更新:
LstAccessAnywhereHistory
応答の更新:
要求例:
<?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(セキュリティコンテキスト)>
<siteName>sqdemo6</siteName>
<webExID>テスト</webExID>
<password>P@ss1234</password>
</securityContext(セキュリティコンテキスト)>
</ヘッダー>
<ボディ>
<bodyContent xsi:type="java:com.webex.service.binding.history.LstAccessAnywhereHistory">
<hostWebexID>test1</hostWebexID>
<startTimeScope>
<sessionStartTimeStart>2019/09/29 00:42:34</sessionStartTimeStart>
<sessionStartTimeEnd>2019/12/29 04:42:34</sessionStartTimeEnd>
</startTimeScope>
<endTimeScope>
<sessionEndTimeStart>2019年9月29日 02:42:34</sessionEndTimeStart>
<sessionEndTimeEnd>2019/12/29 05:42:34</sessionEndTimeEnd>
</endTimeScope>
<listControl>
<serv:startFrom>1</serv:startFrom>
<serv:maximumNum>10</serv:maximumNum>
<serv:listMethod>または</serv:listMethod>
</listControl>
<orderBy>スタートタイム</orderBy>
<orderAD>ASC</orderAD>
</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:LstAccessAnywhereHistoryResponse"
xmlns:xsi="""http://www.w3.org/2001/XMLSchema-instance">
<history:matchingRecords>
<serv:total>775</serv:total>
<serv:returned>10</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
<history:accessAnyWhereInfo>
<history:confID>123456</history:confID>
<history:userName>ディーン</history:userName>
6926_dean</history:computerName>
<history:clientIP>10.224.222.183</history:clientIP>
<history:startTime>2019/11/29 03:05:44</history:startTime>
<history:endTime>2019/11/29 03:10:06</history:endTime>
<history:duration>5</history:duration>
</serv:bodyContent>