XML API 39 および XML API 11 の詳細については、『Cisco Webex Meetings XML API の更新概要 (XML API 39 以前)』を参照してください。

XML API 11 SP9 以前の更新については、「Cisco DevNet」に移動してください。

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&em</partnerID>
</securityContext>
</header>
    <body>
        <bodyContent
            xsi:type="java:com.webex.service.binding.attendee.GetEnrollmentInfo">
            <sessionKey>716773566</sessionKey>
        </bodyContent>
    </body>
</serv:message>

GetEnrollmentInfo 応答例:

<?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:att="http://www.webex.com/schemas/2002/06/service/attendee">
    <serv:header>
        <serv:response>
            <serv:result>成功</serv:result>
            <serv:gsbStatus>プライマリ</serv:gsbStatus>
        </serv:response>
    </serv:header>
    <serv:body>
        <serv:bodyContent xsi:type="att:getEnrollmentInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <att:session>
                <att:confID>154279066999981548</att:confID>
                <att:attendee>
                    <att:attendeeID>3191792</att:attendeeID>
                    <att:enrollFields>
                        <att:defaultFields>
                            <att:firstName>Alex</att:firstName>
                            <att:lastName>Yang</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>02/27/2020 22:03:57</att:submitTime>
                    <att:status>承認</att:status>
                </att:attendee>
                <att:attendee>
                    <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>02/27/2020 22:07:38</att:submitTime>
                    <att:status>承認</att:status>
                </att:attendee>
                <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:session>
        </serv:bodyContent>
    </serv:body>
</serv:message>

API 40.2.0 更新

XML 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>
</serv:message>

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>失敗</serv:result>
            <serv:reason>申し訳ありません。レコードが見つかりませんでした</serv:reason>
            <serv:gsbStatus>プライマリ</serv:gsbStatus>
            <serv:exceptionID>000015</serv:exceptionID>
        </serv:response>
    </serv:header>
    <serv:body>
        <serv:bodyContent/>
    </serv:body>
</serv:message>

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 更新

ここをクリックして、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: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>
     <webExID>userID</webExID>
     <password>*****</password>
     <partnerID>webexpartner</partnerID>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.meeting.CreateMeeting">
    <metaData>
        <confName>Test_Auto_Generated_mtg_pwd</confName>
        <meetingType>3</meetingType>
    </metaData>

<schedule>
  <startDate>10/28/2020 17:35:00</startDate>
</schedule>
</bodyContent>
</body>
</serv:message>

CreateMeeting 応答例:

<?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:meet="http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att="http://www.webex.com/schemas/2002/06/service/attendee">
    <serv:header>
        <serv:response>
            <serv:result>成功</serv:result>
            <serv:gsbStatus>プライマリ</serv:gsbStatus>
        </serv:response>
    </serv:header>
    <serv:body>
        <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>
                <serv:host>https://hmwds6.qa.webex.com/hmwds6/j.php?MTID=md225d5935256319ef21b71dd8ebd0640</serv:host>
                <serv:attendee>https://hmwds6.qa.webex.com/hmwds6/j.php?MTID=m26bf5e25ca587d32302fb29951b92e15</serv:attendee>
            </meet:iCalendarURL>
            <meet:guestToken>cfc7f3246d4862f1bb69b803e8615b7a</meet:guestToken>
        </serv:bodyContent>
    </serv:body>
</serv:message>

CreateEvent 応答には、eventPassword 要素が追加され ました。

CreateTrainingSession および CreateTeleconferenceSession 応答には、sessionPassword 要素が含まれるようになりました。

API 40.1.0 更新

XML API 40.1.0 更新

ここをクリックして、XML API 40.1 スキーマをダウンロードします。

GetSessionInfo の強化

新しい要素を GetSessionInfo API に追加しました。 API がモバイル デバイスの情報を返します。

影響を受けるAPI:

  • GetSessionInfo

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>sqdemo11</siteName>
        <webExID>siteadmin</webExID>
        <password>P@ss1234</password>
    </securityContext>
</header>
<body>
    <bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
        <sessionKey>713707633</sessionKey>
        <pmrUrl>https://go.webex.com/join/dongchen</pmrUrl>
        <sipUrl>dongchen@go.webex.com または 123456789_go@webex.com または 123456789@go.webex.com</sipUrl>
        <meetingLink>https://go.webex.com/go/j.php?MTID=m814c6a483d4b5052d539f88d67acbad6</meetingLink>
        <meetingUuid>34567323456787654323456787654</meetingUuid>
    </bodyContent>
</body>
</serv:message>

LstAccessAnywhereHistory の強化

Webex Access Anywhere レポートの情報を使用して応答するために、新しい API である lstAccessAnywhereHistory を追加しました。

影響を受けるAPI:

  • LstAccessAnywhereHistory

LstAccessAnywhereHistory 要求の更新:

LstAccessAnywhereHistory 応答の更新:

要求例:

<?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>テスト</webExID>
<password>P@ss1234</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.history.LstAccessAnywhereHistory">
<hostWebexID>test1</hostWebexID>
<startTimeScope>
<sessionStartTimeStart>09/29/2019 00:42:34</sessionStartTimeStart>
<sessionStartTimeEnd>12/29/2019 04:42:34</sessionStartTimeEnd>
</startTimeScope>
<endTimeScope>
<sessionEndTimeStart>09/29/2019 2:42:34</sessionEndTimeStart>
<sessionEndTimeEnd>12/29/2019 5:42:34</sessionEndTimeEnd>
</endTimeScope>
<listControl>
<serv:startFrom>1</serv:startFrom>
<serv:maximumNum>10</serv:maximumNum>
<serv:listMethod>--または--</serv:listMethod>
</listControl>
<order>
<orderBy>STARTTIME</orderBy>
<orderAD>ASC</orderAD>
</order>
</bodyContent>
</body>
</serv:message>

応答例:

<?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>プライマリ</serv:gsbStatus>
        </serv:response>
    </serv:header>
    <serv:body>
        <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>dean</history:userName>
                <history:computerName>6926_dean</history:computerName>
                <history:clientIP>10.224.222.183</history:clientIP>
                <history:startTime>11/29/2019 03:05:44</history:startTime>
                <history:endTime>11/29/2019 3:10:06</history:endTime>
                <history:duration>5</history:duration>
            </history:accessAnyWhereInfo>
        </serv:bodyContent>
    </serv:body>
</serv:message>