如需 XML API 39 和 XML API 11 的相關資訊,請參閱 Cisco Webex Meetings XML API 更新概觀(XML API 39 和更低版本)

如需 XML API 40 和 XML API 11 的相關資訊,請參閱 Cisco Webex Meetings XML API 更新概觀(XML API 40 和更高版本)

如需 XML API 11 SP9 及更早版本的更新,請轉至 Cisco DevNet

API 41.6.0 更新

XML API 41.6.0 更新

按一下這裡以下載 XML API 41.6.0 綱要

XMLAPI 支援 Webex Events 2.0 佈建

受影響的 API

GetUser:傳回新元素命名 largeEventCapacity 顯示此使用者帳戶下新 Event 2.0 (EC 2.0) 的容量。 比方說,如果使用者帳戶具有 CI_EC3K 授權,則 largeEventCapacity 的值為 3000。

綱要變更

回應範例

GetUserResponse:

XMLAPI LstRecording 的 CreateTime 會套用錄製開始時間

受影響的 API

LstRecordingLstRecording 回應中傳回 CreateTime 作為使用者實際按下錄製按鈕的時間。

詳細資料

過去,XML API 使用資料庫中建立錄製檔時的時間戳記作為 LstRecording 回應中的建立時間。 現在是使用者實際開始建立錄製檔的時間。 此變更會套用至所有服務錄製檔。 沒有綱要變更。

API 41.5.0 更新

XML API 41.5.0 更新

按一下這裡以下載 XML API 41.5.0 綱要

XMLAPI 能夠以主持人身分從 PSTN 開始 Webex 排定的會議

受影響的 API

  • CreateUser:在以下情況下會產生 hostPIN :當使用者角色是主持人、完全管理員、唯讀管理員或使用者管理網站管理員時,而無論是否啟用了使用者 PMR。

  • SetUser:在以下情況下會設定 hostPIN 使用 phones.hostPIN :當 personalMeetingRoom.hostPIN 不在 XML 請求中時(前提條件: 功能切換 AllowStartScheduledMtgFromPhone已啟用)。

  • GetUser:會傳回 phones.hostPIN ,而無論是否啟用了使用者 PMR。(前提條件: 功能切換 AllowStartScheduledMtgFromPhone 已啟用)。

綱要變更

GetUserResponse

SetUser

回應範例

GetUserResponse

SetUser

XMLAPI GetSite 為行動用戶端回應兩個新元素

受影響的 API

  • GetSiteGetSite 現在將回應兩個新元素以支援行動用戶端具有顯示或不顯示錄製檔標籤的邏輯。

    • enableRecordingAccess :true 或 false,Webex 超級管理員可以啟用或停用錄製檔存取,方式是切換 ( EnableRecordingAccesses )。

    • storageEmptyStatus :true 或 false,如果兩個網站都不支援 NBR 功能並且已將 NBR 儲存空間分配為零,則狀態回應為 true,否則為 false。

綱要變更

下列項目的範例請求: GetSite

下列項目的範例回應: Getsite

具有非 ASCII 字元的電子郵件主旨將使用 RFC2047 進行編碼。 如果是純 ASCII 字元的電子郵件主旨,則沒有編碼

受影響的 API

對任何 API 請求、回應承載都沒有任何影響,但它會變更電子郵件主旨的編碼行為。 如果電子郵件主旨具有非 ASCII 字元,將使用 RFC2047 進行編碼。 如果是純 ASCII 字元的電子郵件主旨,則沒有編碼。

綱要變更

沒有綱要變更。

API 41.4.0 更新

XML API 41.4.0 更新

按一下這裡以下載 XML API 41.4.0 綱要

建立活動排定的 Webex Events,可以利用網站層級的進入與離開音效預設值

XMLAPI 能夠配合目前用於控制進入與離開音效的新邏輯。 Webex Events 的所有音效都由網站管理中的不同設定控制。 位於 GetSite 中,XMLAPI 會傳回額外的欄位 entryExitToneEC 以指示值。 原本在網站管理員設定音效的預設設定時,建立活動不會套用 XMLAPI 預設值而利用此設定。

受影響的 API

XML API: GetSite 會傳回一個新元素entryExitToneEC 以指示值。

XML API: CreateEvent、SetEvent、GetEvent 後端商業邏輯會讀取下列元素的值:entryExitToneEC

綱要變更

XML API: GetSite 回應範例:

<ns1:defaults>
    <ns1:emailReminders>true</ns1:emailReminders>
    <ns1:entryExitTone>ANNOUNCENAME</ns1:entryExitTone>
    <ns1:entryExitToneEC>NOTONE</ns1:entryExitToneEC>
    <ns1:voip>true</ns1:voip>
    <ns1:teleconference>
        <ns1:telephonySupport>NONE</ns1:telephonySupport>
    </ns1:teleconference>
    <ns1:joinTeleconfNotPress1>true</ns1:joinTeleconfNotPress1>
    <ns1:updateTSPAccount>false</ns1:updateTSPAccount>
</ns1:defaults>

影響 API:

  • GetSite

  • CreateEvent

  • SetEvent

  • GetEvent

XMLAPI 僅返回大型活動 (Webex Event 2.0) 詳細資訊

  1. 如果 Webex 會議是大型活動或網路廣播,則 GetSessionInfo 會傳回一些詳細資訊,包括會議密碼、會議數字密碼、答疑者密碼和答疑者數字密碼(不會變更任何綱要)。

  2. XMLAPI 不支援建立和編輯任何大型活動或網路廣播功能,因此 CreateMeetingSetMeeting 對於大型活動或網路廣播的情況,會傳回新的異常狀況(110064:不支援活動與網路廣播階段作業類型。)

影響 API

API 名稱

說明

附註

GetSessionInfo

如果 Webex 會議是大型活動或網路廣播,則 GetSessionInfo 會傳回會議密碼、會議數字密碼、答疑者密碼和答疑者數字密碼。

不會變更任何架構。

CreateMeeting

SetMeeting

如果使用者嘗試使用 CreateMeeting API 來建立類型為大型活動階段作業的 Webex 會議,或調用 SetMeeting 來編輯實際上是大型活動或網路廣播的 Webex 會議,則會傳回新的異常狀況 110064。 不支援活動與網路廣播階段作業類型。

行為已變更。

API 41.3.0 更新

XML API 41.3.0 更新

按一下這裡以下載 XML API 41.3.0 綱要

XML API 新變更支援 Webex Events 2.0 功能

受影響的 API

這兩個 API: GetSessionInfo 和 GetMeeting 也會傳回元素 enableEventenableWebniar

元素名稱

說明

enableEvent

在 Webex 會議中支援 EC 2.0

enableWebniar

在 Webex 會議中支援網路研討會


XMLAPI 支援會為 EC 2.0 返回上述兩個元素。 目前的 XML API 發行版本不支援排定和設定 EC2.0 會議。

綱要變更

GetSessionInfo 會傳回元素 enableEventenableWebniar (針對 EC 2.0)。

GetMeeting 會傳回元素 enableEventenableWebniar (針對 EC 2.0)。

回應範例:

GetSessionInfo 回應:

<ep:accessControl>
                <ep:listStatus>PUBLIC</ep:listStatus>
                <ep:registration>false</ep:registration>
                <ep:passwordReq>true</ep:passwordReq>
                <ep:isEnforceAudioPassword>false</ep:isEnforceAudioPassword>
                <ep:isEnforceAudioLogin>false</ep:isEnforceAudioLogin>
                <ep:enableEvent>false</ep:enableEvent>
                <ep:enableWebniar>false</ep:enableWebniar>

                <ep:enablePreMeetingLobby>true</ep:enablePreMeetingLobby>
            </ep:accessControl>

GetMeeting 回應:

  <meet:supportPKI>false</meet:supportPKI>
                <meet:HQvideo>true</meet:HQvideo>
                <meet:HDvideo>true</meet:HDvideo>
                <meet:viewVideoThumbs>true</meet:viewVideoThumbs>
                <meet:enableEvent>false</meet:enableEvent>
                <meet:enableWebniar>false</meet:enableWebniar>

                <meet:enablePreMeetingLobby>true</meet:enablePreMeetingLobby>
            </meet:enableOptions>

XMLAPI 新變更支援會議前大廳功能

受影響的 API

XML API: GetSiteLstSummarySessionGetSessionInfoGetMeeting 將回應新元素 enablePreMeetingLobby (針對會議前大廳)。

綱要變更

XML API: GetSite 會傳回元素 enablePreMeetingLobby (針對會議前大廳)。

XML API: LstSummarySession 會傳回元素 enablePreMeetingLobby (針對會議前大廳)。

XML API: GetSessionInfo 會傳回元素 enablePreMeetingLobby (針對會議前大廳)。

XML API: GetMeeting 會傳回元素 enablePreMeetingLobby (針對會議前大廳)。

回應範例:

GetSite 回應:

<ns1:siteCommonOptions>
                    <ns1:SupportCustomDialRestriction>false</ns1:SupportCustomDialRestriction>
                    <ns1:SupportTelePresence>false</ns1:SupportTelePresence>
                    <ns1:SupportTelePresencePlus>false</ns1:SupportTelePresencePlus>
                    <ns1:EnableCloudTelepresence>true</ns1:EnableCloudTelepresence>
                    <ns1:EnableCMRForAllUsers>true</ns1:EnableCMRForAllUsers>
                    <ns1:enablePersonalMeetingRoom>true</ns1:enablePersonalMeetingRoom>
                    <ns1:SupportAlternateHost>true</ns1:SupportAlternateHost>
                    <ns1:SupportXMLAPIReturnScheduledPMR>false</ns1:SupportXMLAPIReturnScheduledPMR>
                    <ns1:SupportAnyoneHostMeetings>true</ns1:SupportAnyoneHostMeetings>
                    <ns1:enablePreMeetingLobby>true</ns1:enablePreMeetingLobby>
                </ns1:siteCommonOptions>

LstSummarySession 回應:

<ep:isException>false</ep:isException>
                <ep:isNextUpcomingInstance>true</ep:isNextUpcomingInstance>
                <ep:seriesMeetingKey>0</ep:seriesMeetingKey>
                <ep:isScheduledPMR>false</ep:isScheduledPMR>
                <ep:enableEvent>false</ep:enableEvent>
                <ep:enableWebniar>false</ep:enableWebniar>
               <ep:enablePreMeetingLobby>true</ep:enablePreMeetingLobby>
            </ep:session>

GetSessionInfo 回應:

<ep:accessControl>
                <ep:listStatus>PUBLIC</ep:listStatus>
                <ep:registration>false</ep:registration>
                <ep:passwordReq>true</ep:passwordReq>
                <ep:isEnforceAudioPassword>false</ep:isEnforceAudioPassword>
                <ep:isEnforceAudioLogin>false</ep:isEnforceAudioLogin>
                <ep:enableEvent>false</ep:enableEvent>
                <ep:enableWebniar>false</ep:enableWebniar>
                <ep:enablePreMeetingLobby>true</ep:enablePreMeetingLobby>
            </ep:accessControl>

GetMeeting 回應:

<meet:supportPKI>false</meet:supportPKI>
                <meet:HQvideo>true</meet:HQvideo>
                <meet:HDvideo>true</meet:HDvideo>
                <meet:viewVideoThumbs>true</meet:viewVideoThumbs>
                <meet:enableEvent>false</meet:enableEvent>
                <meet:enableWebniar>false</meet:enableWebniar>
                <meet:enablePreMeetingLobby>true</meet:enablePreMeetingLobby>
            </meet:enableOptions>

XML API GetSite 回應資訊行為變更披露

受影響的 API

XML API: GetSite 僅為管理員帳戶回應以下元素,其中包括角色: SiteAdminRO_SiteAdminUserAdmin

<ns1:activeUserCount>...</ns1:activeUserCount>
<ns1:EEActiveUserCount>...</ns1:EEActiveUserCount>
<ns1:activeCETHost>...</ns1:activeCETHost>
<ns1:auoActiveUserCount>...</ns1:auoActiveUserCount>
<ns1:MCActiveUserCount>...</ns1:MCActiveUserCount>
<ns1:ECActiveUserCount>...</ns1:ECActiveUserCount>
<ns1:TCActiveUserCount>...</ns1:TCActiveUserCount>
<ns1:SCActiveUserCount>...</ns1:SCActiveUserCount>

行為已變更

僅允許管理員角色具有下列項目的回應授權資料GetSite。 主持人或出席者不會在 GetSite 回應中的建立時間。

以下是 API: GetSite's 回應範例(針對 siteadmin 或唯讀 siteadmin 或使用者管理管理員):

API 41.2.0 更新

XML API 41.2.0 更新

按一下這裡以下載 XML API 41.2.0 綱要

如果網站支援 Webex 電話語音,XML API 應該支援「CMR 混合 VOIP」

受影響的 API

  • GetSite 會在回應中傳回新元素 IsWebexTelephony

  • CreateUserSetUser 可以更新 cmrHybridVoip 元素,前提是 IsWebexTelephony 為 true(連同其他條件)。 IsTSPUsingTelephonyAPI 不再重要。

綱要變更

XML API: GetSite 回應會傳回其他元素 IsWebexTelephony

GetSite 回應包括以下新元素:

<ns1:telephonyConfig>

<ns1:isWebexTelephony>true</ns1:isWebexTelephony>
<ns1:isTSPUsingTelephonyAPI>false</ns1:isTSPUsingTelephonyAPI>
<ns1:serviceName>Personal Conference No.</ns1:serviceName>
<ns1:participantAccessCodeLabel>Attendee access code</ns1:participantAccessCodeLabel>
<ns1:subscriberAccessCodeLabel>Host access code</ns1:subscriberAccessCodeLabel>
<ns1:attendeeIDLabel>Attendee ID</ns1:attendeeIDLabel>

.....

</ns1:telephonyConfig>

LstSummarySession 支援 EC2.0

XML API 會受影響

LstSummarySession 將傳回兩個新元素來支援 EC 2.0

元素名稱

說明

enableEvent

在 Webex 會議中支援 EC 2.0

enableWebniar

在 Webex 會議中支援網路研討會

綱要變更

XML API: LstSummarySession 附加 < enableEvent> 和 < enableWebniar> 元素

XML API 的回應: LstSummarySession

EC 2.0 的回應

<ep:isNextUpcomingInstance>true</ep:isNextUpcomingInstance>

                <ep:seriesMeetingKey>0</ep:seriesMeetingKey>
                <ep:isScheduledPMR>false</ep:isScheduledPMR>
                <ep:enableEvent>true</ep:enableEvent>
                <ep:enableWebniar>true</ep:enableWebniar>
            </ep:session>

XMLAPI 支援傳回網站使用者 Webex-voice-assistant 選項以進行 MCT 整合

受影響的 API

GetUser 會在回應中傳回新元素 webexAssistantEnabled (true 或 false)。

綱要變更

getUserResponse

回應範例

API 41.1.0 更新


XML API 41.1 綱要存在綱要變更。