نظرة عامة على تحديثات واجهة برمجة تطبيقات Cisco Webex Meetings (API 41)

لمزيد من المعلومات حول XML API 39 وXML API 11، راجع نظرة عامة على تحديثات واجهة برمجة تطبيقات XML الخاصة باجتماعات Cisco Webex (XML API 39 والإصدارات الأقدم).

لمزيد من المعلومات حول XML API 40، راجع نظرة عامة على تحديثات واجهة برمجة تطبيقات XML الخاصة باجتماعات Cisco Webex (XML API 40 والإصدارات الأحدث).

للحصول على التحديثات الخاصة بـ XML API 11 SP9 والإصدارات الأقدم، انتقل إلى Cisco DevNet.

تحديثات XML API 41.12.0

انقر هنا لتنزيل مخطط XML API 41.12.0.

سوف يقوم XMLAPI بحظر جدولة أحداث Webex (الكلاسيكية) وتحريرها وفقًا لعنصر تكوين الموقع EnableClassicEvent الذي يكون خاطئًا

التغييرات المتأثرة في واجهات برمجة التطبيقات والمخططات

في صفحة تكوين إدارة الموقع، إذا كان مربع الاختيار تمكين الحدث الكلاسيكي خاطئًا، فلن يدعم هذا الموقع اجتماعات Webex Events (الكلاسيكية) بعد الآن.

إذا تم تعيين مربع الاختيار تمكين classicEvent على خطأ، يمكنك استدعاء واجهات برمجة التطبيقات التالية لتشغيل اجتماع Webex Events (الكلاسيكي):

إنشاء حدث، تعيين حدث، الحصول على حدث، الحصول على معلومات الجلسة، حدث مسجل، حدث مسجل، برنامج مسجل، تحميل صورة الحدث

ستستجيب واجهة برمجة التطبيقات للاستثناء الجديد 010106 تم تعطيل الحدث الكلاسيكي.

تغييرات المخطط

لا يوجد تغييرات في المخطط.

مثال على طلب واستجابة واجهة برمجة التطبيقات

طلب واستجابة API CreateEvent

طلب إنشاء حدث

XXXXXXXX


اختبار EC لـ XMLAPI


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>FAILURE</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 يؤثر على واجهات برمجة التطبيقات:

• تعيين الحدث الحصول على الحدث

• الحصول على معلومات الجلسة

• حدث تاريخي

• حدث مسجل

• برنامج المذكرات

• تحميل صورة الحدث

سيتم الرد على XMLAPI LstMeetingType للعنصر الجديد في subProductCodePrefix

واجهات برمجة التطبيقات المتأثرة

عنصر الاستجابة الحالي لواجهة برمجة التطبيقات LstMeetingType لـ productionCodePrefix: PRO وAUO وغيرها من البادئات التي تم تحديدها مسبقًا لـ Webex.

بعد هذا التحسين الجديد، ستستجيب واجهة برمجة التطبيقات للعناصر الجديدة من subProdctCodePrefix:PRO1، PRO2، وما إلى ذلك، والتي يمكن تخصيصها لتلبية بادئة النوع.

تغييرات المخطط على واجهة برمجة التطبيقات: نوع الاجتماع الأخير

سوف يستجيب العنصر الجديد: كود المنتج الفرعي

مثال على طلب واستجابة واجهة برمجة التطبيقات

طلب واستجابة واجهة برمجة التطبيقات 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>

تحديثات XML API 41.11.0

انقر هنا لتنزيل مخطط XML API 41.11.0.

دعم واجهة برمجة تطبيقات XML للتوافق الأمامي في واجهة برمجة تطبيقات إدارة المستخدمين لمواقع Control Hub المُدارة

التغييرات المتأثرة في واجهات برمجة التطبيقات والمخططات

إذا كان تطبيق التكامل الخاص بك يستخدم حاليًا واجهات برمجة تطبيقات إدارة مستخدمي Webex XMLAPI: CreateUser وSetUser وDelUser وGetUser لتوفير أو إدارة المستخدمين، بعد تحويل موقع Webex الكلاسيكي الخاص بك إلى موقع مُدار بواسطة Control Hub، ستستمر واجهات برمجة التطبيقات هذه في العمل لتحقيق التوافق المستقبلي. هناك بعض التغييرات السلوكية كما هو موضح أدناه:

• عند استخدام createUser - إذا لم تكن حالة المستخدم في Control Hub "نشطة"، فلن تكون حالة المستخدم على الموقع نشطة. إذا كانت حالة المستخدم في مركز التحكم هي نشط، فإن حالة المستخدم على الموقع تكون نشطة أيضًا، راجع: حالة المستخدم للمستخدمين الجدد والمحولين في مركز التحكم.

• سيتم تجاهل عنصر password في واجهات برمجة التطبيقات CreateUser وSetUser ، وسنبدأ في إرسال بريد إلكتروني للتفعيل إلى المستخدمين الجدد، ويمكن للمستخدمين النقر فوق الرابط الموجود في البريد الإلكتروني لتنشيط الحساب الجديد وإدخال كلمة المرور الجديدة.

• سيتم تجاهل العنصر النشط في واجهة برمجة التطبيقات CreateUser ، ولا يمكن تنشيط المستخدم الجديد (غير المُتحقق منه) من خلال هذه المعلمة باستخدام واجهة برمجة التطبيقات SetUser.

• يجب أن تكون قيمة عنصر webExId في bodyContent لواجهات برمجة التطبيقات CreateUser مماثلة للبريد الإلكتروني. إذا كان webExId مختلفًا عن email، فسوف نتعامل مع webExId بنفس طريقة البريد الإلكتروني عند تخزينه في WebDB وسيتم تجاهل القيمة.

• يجب أن تكون قيمة عنصر webExId في bodyContent لواجهات برمجة التطبيقات SetUser هي هوية المستخدم أو عنوان البريد الإلكتروني، ويمكنك تغييرها باستخدام <email> في bodyContent.

• ستدعم واجهة برمجة التطبيقات SetUser تغيير البريد الإلكتروني للمستخدم الحالي: يتم تحقيق النجاح إذا كان حساب العملية في SecurityContext هو مسؤول الموقع الكامل في Control Hub. بخلاف ذلك، تقوم واجهة برمجة التطبيقات بالإبلاغ عن خطأ مع رمز خطأ جديد ورسالة أدناه:

  • 030120 يجب أن يكون الحساب مسؤولاً كاملاً عن الموقع لتغيير البريد الإلكتروني.

• سيتم تجاهل العنصر newWebExId في bodyContent الخاص بـ SetUser API .

• تحاول واجهة برمجة التطبيقات SetUser التغيير إلى بريد إلكتروني قيد الاستخدام بالفعل، وتثير واجهة برمجة التطبيقات رمز خطأ جديد ورسالة خطأ أدناه:

  • 030118 يتم استخدام البريد الإلكتروني بالفعل في المواقع التي تتم إدارتها بواسطة Control Hub.

• تقوم واجهة برمجة التطبيقات DelUser بإلغاء تنشيط المستخدم في جانب اجتماع Webex وإزالة ترخيص الاجتماع المقابل من موقع Webex. يمكن إعادة تنشيط هذا المستخدم المعطل باستخدام واجهة برمجة التطبيقات: SetUser (ACTIVATED) طالما تم التحقق من المستخدم من قبل.

• تثير واجهات برمجة التطبيقات CreateUser وSetUser رمز خطأ جديد ورسالة خطأ كما هو موضح أدناه:

  • 030117، هذا المستخدم موجود خارج مؤسستك، لذا يجب المطالبة به، حتى تتمكن من الانتقال إلى مؤسستك من خلال عملية المطالبة بالمستخدم. لمعرفة الخطوات الخاصة بالمطالبة بالمستخدم في مؤسستك، راجع المطالبة بالمستخدمين في مؤسستك (تحويل المستخدمين). سيتعين عليك التحقق من النطاق الذي ينتمي إليه المستخدم قبل المطالبة بالمستخدم.

  • 030119 يجب أن يتضمن رمز وصول CI نطاق webexsquare: admin عند توفير المستخدم.

تغييرات المخطط

لا توجد تغييرات في المخطط على واجهات برمجة التطبيقات هذه: CreateUser، وSetUser، وDelUser، وGetUser.

مثال على طلب واستجابة واجهة برمجة التطبيقات

طلب واستجابة API CreateUser

طلب واجهة برمجة التطبيقات:
xml version="1.0" encoding="UTF-8"?>
xserv: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">
header>
<securityContext>
<siteName>{ siteName} </siteName>
<webExID>{ حساب مسؤول الموقع} </webExID>
<email>{ حساب مسؤول الموقع} </email>
<sessionTicket>xxxx</sessionTicket> أو أو
أو ، عند استخدام CI "accessToken"، يجب أن يتضمن نطاق webexsquare:admin عند توفير المستخدم
</securityContext>




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>
<privilege>
<host>true</host>
</privilege>
<active>ACTIVATED</active> --- لا يمكن لهذه المعلمة تنشيط المستخدم مباشرة حتى يقوم المستخدم بتنشيط نفسه عبر بريد التنشيط الإلكتروني.




مثال على استجابة واجهة برمجة التطبيقات:
ترميز="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>أساسي</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>

التأثير على واجهات برمجة التطبيقات:

• إنشاء مستخدم

• تعيين المستخدم

• حذف المستخدم

تدعم واجهة برمجة تطبيقات XML التوافق الأمامي لمصادقة المستخدم الحالي بعد تحويل موقع Webex الكلاسيكي إلى موقع مُدار بواسطة Control Hub

واجهات برمجة التطبيقات المتأثرة

بعد تحويل موقع Webex الكلاسيكي إلى موقع مُدار بواسطة Control Hub، يجب أن تكون قيمة عنصر في مماثلة للبريد الإلكتروني، التفاصيل أدناه:

• بالنسبة للمستخدمين الحاليين الذين تم إنشاؤهم في موقع Webex الكلاسيكي، فإننا ندعم كل من webExID القديم (على سبيل المثال: جاك) و webExID الجديد (المحتوى هو نفسه البريد الإلكتروني، على سبيل المثال: (على سبيل المثال، إذا كنت تستخدم (Jack@xx.com) لتسجيل الدخول، فإن التوافق مع الإصدارات السابقة للمصادقة مخصص لجميع واجهات برمجة التطبيقات XML.

• بالنسبة للمستخدمين الجدد الذين تم إنشاؤهم في المواقع التي تتم إدارتها بواسطة Control Hub، يجب أن تكون قيمة عنصر webExID هي نفس قيمة البريد الإلكتروني لتسجيل الدخول.

header>

{siteName}
{userName} --- تم إنشاء المستخدمين الحاليين في موقع webEx الكلاسيكي، ويمكن أن يكونوا: jack أو jack@xx.com؛ يجب على المستخدم الجديد استخدام jack@xx.com
xxxx أو أو أو

التأثير على واجهات برمجة التطبيقات:

جميع واجهات برمجة التطبيقات XML.

بعد تحويل موقع Webex الكلاسيكي إلى موقع مُدار بواسطة Control Hub، يجب أن تكون قيمة عنصر <bodyContent> مماثلة للبريد الإلكتروني، التفاصيل أدناه:

• بالنسبة للمستخدمين الحاليين الذين تم إنشاؤهم في موقع Webex الكلاسيكي، فإننا ندعم كلاً من webExId القديم (على سبيل المثال: جاك) و webExId جديد (المحتوى هو نفسه البريد الإلكتروني، على سبيل المثال: Jack@xx.com) في bodyContent.

• بالنسبة للمستخدمين الجدد الذين تم إنشاؤهم في المواقع التي تتم إدارتها بواسطة Control Hub، يجب أن تكون قيمة عنصر webExId هي نفسها قيمة البريد الإلكتروني في bodyContent.

xxxx --- تم إنشاء المستخدمين الحاليين في موقع webEx الكلاسيكي، ويمكن أن يكونوا: jack أو jack@xx.com؛ يجب على المستخدم الجديد استخدام jack@xx.com

التأثير على واجهات برمجة التطبيقات: GetUser، وSetUser، وDelUser.

تغييرات المخطط

لا يوجد تغييرات في المخطط على أي واجهات برمجة التطبيقات.

مثال على طلب واستجابة واجهة برمجة التطبيقات

طلب واستجابة واجهة برمجة التطبيقات GetUser

طلب واجهة برمجة التطبيقات:
xml version="1.0" encoding="UTF-8"?>
xserv: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">
header>

{ siteName}
{ userName} --- تم إنشاء المستخدمين الحاليين في موقع webEx الكلاسيكي، ويمكن أن يكونوا: jack أو jack@xx.com؛ يجب على المستخدم الجديد استخدام jack@xx.com
xxxx أو أو أو


body>
bodyContent xsi:type="java:com.webex.service.binding.user.GetUser أو SetUser أو DelUser">
xxxx --- تم إنشاء المستخدمين الحاليين في موقع webEx الكلاسيكي، ويمكن أن يكونوا: jack أو jack@xx.com؛ يجب على المستخدم الجديد استخدام jack@xx.com




مثال على استجابة واجهة برمجة التطبيقات:
... نفس ما سبق

تحسين واجهة برمجة تطبيقات عرض سجل تسجيلات الويب لدعم اجتماعات Webex، وأحداث Webex (الجديدة)، وأحداث Webex (الكلاسيكية)

واجهات برمجة التطبيقات المتأثرة

واجهة برمجة التطبيقات الحالية: يدعم كل من lstrecordaccessHistory وlstrecordaccessDetailHistory فقط تقرير سجل الوصول إلى عرض تسجيلات التدريبات على Webex. يدعم التحسين الجديد أيضًا عرض سجل الوصول إلى التسجيل في Webex Meetings وWebex Events (جديد) وWebex Events (كلاسيكي) أيضًا.

تغييرات المخطط

نحن ندعم المخطط الجديد أدناه في API lstrecordaccessHistory في نص طلب API:

مركز الاجتماعات
مركز التدريب
مركز الأحداث

تفاصيل

واجهة برمجة التطبيقات: lstrecordaccessHistory قادر على إرجاع سجل الوصول إلى عرض التسجيل لاجتماعات Webex، وأحداث Webex (الجديدة)، وأحداث Webex (الكلاسيكية)، وتدريبات Webex.

• إذا لم يتم تحديد serviceType في طلب واجهة برمجة التطبيقات، فإن واجهة برمجة التطبيقات lstrecordaccessHistory تعيد سجل الوصول إلى عرض تسجيلات تدريبات Webex فقط.

• عندما يكون serviceType هو MeetingCenter، فإن واجهة برمجة التطبيقات الخاصة بـ lstrecordaccessHistory تعيد سجل الوصول إلى عرض تسجيل اجتماعات Webex وأحداث Webex (جديدة).

• عندما يكون serviceType هو EventCenter، تقوم واجهة برمجة التطبيقات الخاصة بـ lstrecordaccessHistory بإرجاع سجل الوصول إلى عرض تسجيل أحداث Webex (الكلاسيكي).

واجهة برمجة التطبيقات: يمكن لـ lstrecordaccessDetailHistory إرجاع التفاصيل حسب recordID لاجتماعات Webex، وأحداث Webex (الجديدة)، وأحداث Webex (الكلاسيكية)، وتدريبات Webex.

مثال على طلب واستجابة واجهة برمجة التطبيقات

طلب واستجابات واجهة برمجة التطبيقات lstrecordaccessHistory

<?xml version="1.0" encoding="UTF-8"?>
serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<header>
<securityContext>
{اسم المستخدم}
{كلمة المرور}
اسم الموقع>{اسم الموقع}
</securityContext>
</header>
<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/></head><body dir="rtl">
<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>RECORDID</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>أساسي</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 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>06/10/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

<?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>
{اسم المستخدم}webExID>
{كلمة المرور}}
siteName>{اسم الموقع}}</siteName>

</header>
<body>
<bodyContent xsi:type=
"java:com.webex.service.binding.history.LstrecordaccessDetailHistory">
<recondID>1XXXXXX7</recondID>
<timeZoneID>20</timeZoneID>
</bodyContent>





نجاح
أساسي




<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: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>


?>
http://www.webex.com/schemas/2002/06/service"http://www.webex.com/schemas/2002/06/common"http://www.webex.com/schemas/2002/06/service/history">
http://www.w3.org/2001/XMLSchema-instance">

التأثير على واجهات برمجة التطبيقات:

• سجل الوصول إلى السجل

• lstrecordaccessتفاصيلالتاريخ

إصلاح الفجوة في الحد الأقصى المسموح به لطول وصف أحداث Webex (الكلاسيكية) بين XMLAPI وصفحة Webex.

واجهات برمجة التطبيقات المتأثرة

واجهة برمجة التطبيقات XML: سيسمح عنصر الوصف description في CreateEvent وSetEvent بإدخالات تصل إلى 10000 حرف كحد أقصى، وفي حالة إدخال حجم أكبر من الحجم المطلوب، فسيؤدي ذلك إلى ظهور رمز الخطأ الجديد والرسالة:

060068 وصف الإدخال غير القانوني. لا يمكن أن يتجاوز هذا الوصف 10000 حرف.

تغييرات المخطط

لا يوجد تغيير في المخطط.

مثال على طلب واستجابة واجهة برمجة التطبيقات

طلب واستجابة API CreateEvent

#مثال على طلب واجهة برمجة التطبيقات:
...

<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>
...


------------------------------------
#مثال على استجابة واجهة برمجة التطبيقات عندما يتجاوز الوصف 10000 حرف:

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

التأثير على واجهات برمجة التطبيقات:

• إنشاء حدث

• تعيين الحدث

واجهة برمجة التطبيقات XML: يقوم GetUser بإرجاع عنصر جديد من freeAccount

واجهات برمجة التطبيقات المتأثرة

GetUser يعيد عنصرًا جديدًا يحدد ما إذا كان حساب المستخدم هو FreeAccount أم لا.

تغييرات المخطط

مثال على استجابة GetUser

احصل على استجابة المستخدم:
AW
false

3
false

التأثير على واجهات برمجة التطبيقات:

الحصول على المستخدم

تحديثات XML API 41.9.0

انقر هنا لتنزيل مخطط XML API 41.9.0.

إلغاء تشغيل XML API 10.0.0 لجميع مواقع T31

تخطط Webex لإنهاء دعم XML API الإصدار 10.0.0 لجميع مواقع T31.

نحن نقوم بإلغاء استخدام كود XML API 10.0.0 من جميع الإنتاجات في تحديث 41.9.0.

تحديثات XML API 41.8.0

انقر هنا لتنزيل مخطط XML API 41.8.0.

إلغاء تشغيل XML API 10.0.0 لجميع مواقع T31

تخطط Webex لإنهاء دعم XML API الإصدار 10.0.0 لجميع مواقع T31.

اكتشفت Webex أن بعض عملاء الشركة يستخدمون عنوان URL الخاص بـ XML API بطريقة غير صحيحة مثل: https://{siteName}.webex.com/WBXService/xml10.0.0/XMLService، الطريقة الصحيحة للوصول إلى عنوان URL لواجهة برمجة تطبيقات XML على النحو التالي: https://{siteName}.webex.com/WBXService/XMLService.

يرجى تبديل الوصول إلى كود API XML الخاص بك بالطريقة الصحيحة لتجنب التأثير قبل نهاية دعمنا على إصدار XML API 10.0.0.

تحديثات XML API 41.7.0

انقر هنا لتنزيل مخطط XML API 41.7.0.

يجب التحكم في حذف وتحرير التسجيل عبر الهاتف المحمول من خلال خيار إدارة الموقع: السماح للمضيفين بإعادة تعيين التسجيلات وتحريرها وتعطيلها وحذفها

التغييرات المتأثرة في واجهات برمجة التطبيقات والمخططات

احصل على الموقع: سيتم إرجاع عناصر جديدة باسم enableNBRMCModify، وseparateNoRecordingEdit ضمن الأدوات.

مثال على الرد

احصل على استجابة الموقع:

احصل على الموقع

<?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>أساسي</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>خطأ</ns1:enableNBRMCModify>
<ns1:separateNoRecordingEdit>صحيح</ns1:separateNoRecordingEdit>
...
</ns1:tools>
</serv:bodyContent>

تحديثات XML API 41.6.3

انقر هنا لتنزيل مخطط XML API 41.6.3.

GetSite استجابة عنصر جديد لـ supportLargeEvent

التغييرات المتأثرة في واجهات برمجة التطبيقات والمخططات

احصل على الموقع: يعيد عناصر جديدة تحمل اسم supportLargeEvent ضمن siteCommonOptions لإعلام المتصل بما إذا كان الموقع يدعم الحدث الكبير (حدث Webex (جديد)) أم لا.

تغيير المخطط

مثال على الرد

احصل على استجابة الموقع:

احصل على الموقع

<?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>أساسي</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>خطأ</ns1:enablePreMeetingLobby>
<ns1:supportLargeEvent>صحيح</ns1:supportLargeEvent>
</ns1:siteCommonOptions>
</serv:bodyContent>

تحديثات XML API 41.6.0

انقر هنا لتنزيل مخطط XML API 41.6.0.

دعم XMLAPI لـ Webex Events 2.0 في التجهيز

واجهات برمجة التطبيقات المتأثرة

احصل على المستخدم: يقوم بإرجاع اسم العنصر الجديد largeEventCapacity والذي يوضح سعة الحدث الجديد 2.0 (EC 2.0) ضمن حساب المستخدم هذا. على سبيل المثال، إذا كان حساب المستخدم لديه ترخيص CI_EC3K، فإن قيمة largeEventCapacity هي 3000.

تغييرات المخطط

مثال على الرد

احصل على استجابة المستخدم:

يطبق أمر CreateTime في XMLAPI LstRecording وقت بدء التسجيل

واجهات برمجة التطبيقات المتأثرة

التسجيل الأخير: LstRecording استجابة CreateTime باعتبارها الوقت الذي يضغط فيه المستخدم فعليًا على زر التسجيل.

تفاصيل

في الماضي، استخدمت واجهة برمجة تطبيقات XML طابعًا زمنيًا لوقت إنشاء التسجيل في قاعدة البيانات كوقت إنشاء في استجابة LstRecording . الآن حان الوقت ليبدأ المستخدم فعليًا بإجراء التسجيل. ينطبق هذا التغيير على جميع تسجيلات الخدمة. لا يوجد تغيير في المخطط.

تحديثات XML API 41.5.0

انقر هنا لتنزيل مخطط XML API 41.5.0.

تتمتع XMLAPI بالقدرة على بدء اجتماعات Webex المجدولة من PSTN كمضيف

واجهات برمجة التطبيقات المتأثرة

• إنشاء مستخدم: يقوم بإنشاء hostPIN بغض النظر عن تمكين PMR الخاص بالمستخدم أو عدم تمكينه عندما يكون دور المستخدم هو المضيف أو كامل أو للقراءة فقط أو مسؤولي موقع إدارة المستخدم.

• تعيين المستخدم: تعيين hostPIN باستخدام phones.hostPIN عندما لا يكون personalMeetingRoom.hostPIN في طلب XML (شرط مسبق: تم تمكين ميزة التبديل AllowStartScheduledMtgFromPhone ).

• احصل على المستخدم: يعيد phones.hostPIN بغض النظر عن تمكين PMR للمستخدم أم لا. (شرط مسبق: تم تمكين ميزة التبديل AllowStartScheduledMtgFromPhone).

تغييرات المخطط

احصل على استجابة المستخدم:

تعيين المستخدم:

مثال على الرد

احصل على استجابة المستخدم:

تعيين المستخدم:

استجابة XMLAPI GetSite لعنصرين جديدين لعميل الهاتف المحمول

واجهات برمجة التطبيقات المتأثرة

• احصل على الموقع: سيستجيب GetSite الآن لعنصرين جديدين لدعم العميل المحمول الذي لديه المنطق لعرض علامة تبويب التسجيل أو عدم عرضها.

  • تمكين الوصول للتسجيل: صحيح أو خطأ، يمكن لمسؤولي Webex الرئيسيين تمكين أو تعطيل الوصول إلى التسجيل من خلال التبديل (EnableRecordingAccesses).

  • حالة التخزين الفارغة: صحيح أو خطأ، إذا كان كلا الموقعين لا يدعمان وظيفة NBR وقاموا بتخصيص مساحة تخزين NBR على صفر، فإن استجابة الحالة تكون صحيحة، وإلا تكون خاطئة.

تغييرات المخطط

نموذج طلب لـ GetSite

نموذج استجابة لـ Getsite

سيتم ترميز موضوع البريد الإلكتروني الذي يحتوي على أحرف غير ASCII باستخدام RFC2047. في حالة موضوع البريد الإلكتروني الذي يحتوي على أحرف ASCII نقية، لا يوجد ترميز

لا توجد تأثيرات على أي طلب API أو حمولة الاستجابات، ولكنها تغير سلوك ترميز موضوع البريد الإلكتروني. عندما يكون موضوع البريد الإلكتروني يحتوي على أحرف غير ASCII، سيتم ترميزه باستخدام RFC2047. في حالة أن موضوع البريد الإلكتروني يتكون من أحرف ASCII نقية، فلا يوجد تشفير.

تغييرات المخطط

لا يوجد أي تغييرات في المخطط.

تحديثات XML API 41.4.0

انقر هنا لتنزيل مخطط XML API 41.4.0.

إنشاء حدث مجدول يمكن لأحداث Webex الاستفادة من الإعدادات الافتراضية على مستوى الموقع عند الدخول والخروج

يتوافق XMLAPI مع المنطق الجديد الحالي للتحكم في نغمة الدخول والخروج. تم التحكم في جميع نغمات أحداث Webex من خلال إعداد مختلف في إدارة الموقع. في GetSite، يقوم XMLAPI بإرجاع حقل إضافي entryExitToneEC للإشارة إلى القيمة. في الأصل، عندما قام مسؤول الموقع بتعيين إعداد افتراضي للنغمة، لن يقوم إنشاء حدث باستغلال هذا الإعداد من خلال تطبيق الإعداد الافتراضي لـ XMLAPI.

واجهات برمجة التطبيقات المتأثرة

واجهة برمجة التطبيقات XML: يعيد GetSite عنصرًا جديدًا واحدًا entryExitToneEC للإشارة إلى القيمة.

واجهة برمجة التطبيقات XML: يقوم منطق الأعمال الخلفي CreateEvent، SetEvent، GetEvent بقراءة قيمة entryExitToneEC.

تغييرات المخطط

واجهة برمجة التطبيقات XML: عينة استجابة GetSite:

صحيح
إعلان الاسم
لا إعلان
صحيح

لا شيء

صحيح
خطأ

التأثير على واجهات برمجة التطبيقات:

• احصل على الموقع

• إنشاء حدث

• تعيين الحدث

• احصل على الحدث

XMLAPI يعيد فقط معلومات تفصيلية عن الحدث الكبير (Webex Event 2.0)

1. إذا كان اجتماع Webex هو الحدث الكبير أو البث عبر الويب، فإن GetSessionInfo يعيد بعض المعلومات التفصيلية بما في ذلك كلمة مرور الاجتماع وكلمة المرور الرقمية للاجتماع وكلمة مرور المشاركين وكلمة المرور الرقمية لمشاركي اللجنة (لا يمكن تغيير المخطط).

2. لا يدعم XMLAPI إنشاء وتحرير أي حدث كبير أو ميزة بث ويب، لذا فإن CreateMeeting وSetMeeting يعيدان استثناءً جديدًا (110064، لا يتم دعم نوع جلسة الحدث والبث على الويب.) لحالة الحدث الكبير أو البث على الويب.

واجهات برمجة التطبيقات التأثيرية

تحديثات XML API 41.3.0

انقر هنا لتنزيل مخطط XML API 41.3.0.

تدعم التغييرات الجديدة في واجهة برمجة التطبيقات XML ميزة Webex Events 2.0

واجهات برمجة التطبيقات المتأثرة

كلا من واجهات برمجة التطبيقات: يعيد GetSessionInfo و GetMeeting العناصر enableEvent و enableWebniar أيضًا.

تغييرات المخطط

يقوم GetSessionInfo بإرجاع العناصر enableEvent وenableWebniar لـ EC 2.0.

يعيد GetMeeting العناصر enableEvent وenableWebniar لـ EC 2.0.

عينة الرد:

GetSessionInfo الاستجابة:

عام
خاطئ
صحيح
خاطئ
خاطئ
خاطئ
خاطئ
صحيح

الاستجابة لـ GetMeeting :

خطأ
صحيح
صحيح
صحيح
خطأ
خطأ
صحيح

تدعم التغييرات الجديدة في XMLAPI ميزة Pre-Meeting lobby

واجهات برمجة التطبيقات المتأثرة

واجهة برمجة التطبيقات XML: سوف يستجيب GetSite وLstSummarySession وGetSessionInfo وGetMeeting للعنصر الجديد enablePreMeetingLobby لردهة ما قبل الاجتماع.

تغييرات المخطط

واجهة برمجة التطبيقات XML: يعيد GetSite العنصر enablePreMeetingLobby لردهة ما قبل الاجتماع.

واجهة برمجة التطبيقات XML: LstSummarySession يعيد العنصر enablePreMeetingLobby لردهة ما قبل الاجتماع.

واجهة برمجة التطبيقات XML: يعيد GetSessionInfo العنصر enablePreMeetingLobby لردهة ما قبل الاجتماع.

واجهة برمجة التطبيقات XML: يعيد GetMeeting العنصر enablePreMeetingLobby لردهة ما قبل الاجتماع.

عينة الرد:

الاستجابة لـ GetSite :

خطأ
خطأ
خطأ
صحيح
صحيح
صحيح
صحيح
خطأ
صحيح
صحيح

LstSummarySession الاستجابة:

خطأ
صحيح
0
خطأ
خطأ
خطأ
صحيح

GetSessionInfo الاستجابة:

عام
خاطئ
صحيح
خاطئ
خاطئ
خاطئ
خاطئ
صحيح

الاستجابة لـ GetMeeting :

خطأ
صحيح
صحيح
صحيح
خطأ
خطأ
صحيح

إفصاح عن تغيير سلوك استجابة واجهة برمجة تطبيقات XML GetSite

واجهات برمجة التطبيقات المتأثرة

واجهة برمجة التطبيقات XML: GetSite يستجيب فقط أسفل العناصر لحساب المسؤول، والتي تتضمن الأدوار: SiteAdmin، وRO_SiteAdmin، وUserAdmin.

...
ns1:EEActiveUserCount>...
ns1:activeCETHost>...
ns1:auoActiveUserCount>...
ns1:MCActiveUserCount>...
ns1:ECActiveUserCount>...
ns1:TCActiveUserCount>...
ns1:SCActiveUserCount>...

تغير السلوك

السماح فقط لدور المسؤول بالحصول على استجابة بيانات الترخيص من GetSite. لن يحصل المضيف أو الحاضر على بيانات الترخيص هذه في استجابة GetSite .

فيما يلي واجهة برمجة التطبيقات (API): مثال استجابة GetSite لـ siteadmin أو siteadmin الجاهز فقط أو مسؤول إدارة المستخدمين:

تحديثات XML API 41.2.0

انقر هنا لتنزيل مخطط XML API 41.2.0.

يجب أن يدعم XMLAPI "CMR Hybrid VOIP" إذا كان الموقع يدعم الهاتف Webex

واجهات برمجة التطبيقات المتأثرة

• يعيد GetSite عنصرًا جديدًا IsWebexTelephony في الاستجابة.

• يمكن لـ CreateUser وSetUser تحديث عنصر cmrHybridVoip إذا كان IsWebexTelephony صحيحًا مع شروط أخرى. IsTSPUsingTelephonyAPI لم يعد له أي أهمية.

تغييرات المخطط

واجهة برمجة التطبيقات XML: تعيد استجابة GetSite عنصرًا إضافيًا IsWebexTelephony

تتضمن استجابة GetSite هذا العنصر الجديد:

true
false
رقم المؤتمر الشخصي
رمز وصول الحضور
رمز وصول المضيف
معرف الحضور

.....

LstSummarySession يدعم EC2.0

تتأثر واجهات برمجة التطبيقات XML

ستعيد LstSummarySession عنصرين جديدين لدعم EC 2.0

تغييرات المخطط

واجهة برمجة التطبيقات XML: ملخص الجلسة: أضف عنصري <enableEvent> و<enableWebniar>

استجابة واجهة برمجة التطبيقات XML: ملخص الجلسة

الاستجابة لـ EC 2.0

صحيح

0
خطأ
صحيح
صحيح

يدعم XMLAPI إرجاع خيار مستخدم الموقع Webex-voice-assistant للتكامل مع MCT

واجهة برمجة التطبيقات المتأثرة

يعيد GetUser عنصرًا جديدًا webexAssistantEnabled (صواب أو خطأ) في الاستجابة.

تغييرات المخطط

احصل على استجابة المستخدم:

مثال على الرد