- الرئيسية
- /
- المقال
نظرة عامة على تحديثات واجهة برمجة تطبيقات اجتماعات Cisco Webex (API 41)
ابحث عن جميع المعلومات المهمة التي تحتاجها حول واجهة برمجة تطبيقات اجتماعات Cisco Webex، مثل تغييرات المخطط والإعلانات الأخرى.
لمزيد من المعلومات عن XML API 39 وXML API 11، ارجع إلى نظرة عامة على تحديثات Cisco Webex Meetings XML API (XML API 39 والإصدارات الأقدم).
لمزيد من المعلومات عن XML API 40، ارجع إلى نظرة عامة على تحديثات Cisco Webex Meetings XML API (XML API 39 والإصدارات الأحدث
للحصول على تحديثات لحزمة الخدمة SP9 الخاصة بواجهة برمجة تطبيقات XML 11 والإصدارات الأقدم، انتقل إلى Cisco DevNet.
تحديثات API 41.12.0
تحديثات واجهة برمجة تطبيقات XML 41.12.0
سيحظر XMLAPI جدول وتحرير Webex Events (الكلاسيكي) وفقًا لعنصر تكوين الموقع في EnableClassicEvent
غير الصحيح
واجهات برمجة التطبيقات المتأثرة وتغييرات المخطط
في صفحة تكوين إدارة الموقع، إذا كانت خانة الاختيار تمكين الحدث الكلاسيكي خاطئة، فلن يدعم هذا الموقع اجتماعات أحداث Webex (الكلاسيكية ) بعد الآن.
إذا كانت خانة الاختيار تمكين الحدث الكلاسيكي خاطئة، يمكنك استدعاء واجهات برمجة التطبيقات هذه لتشغيل اجتماع أحداث Webex (الكلاسيكي ):
CreateEvent
، SetEvent
، GetEvent
، GetSessionInfo
، LstsummaryEvent
، LstrecordedEvent
، LstsummaryProgram
، UploadEventImage
ستستجيب API للاستثناء الجديد 010106 تم تعطيل الحدث الكلاسيكي.
تغييرات المخطط
لا يتغير المخطط.
مثال على طلب واجهة برمجة التطبيقات والاستجابة لها
طلب API CreateEvent والاستجابة
طلب إنشاء حدث
XXXXXXXX
اختبار XMLAPI EC
07/17/2021 01:29:15
15
استجابة كريت إيفنت
<?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>فشل</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 تؤثر على واجهات برمجة التطبيقات:
-
تعيين الحدث GetEvent
-
GetSessionInfo
-
الحدثComment
-
حدث Lstrecorded
-
ملخصProgram
-
تحميلEventImage
سيتم مسؤولية XMLAPI LstMeetingType
إلى العنصر الجديد في subProductCodePrefix
واجهات برمجة التطبيقات المتأثرة
عنصر استجابة LstMeetingType
الحالي لواجهة برمجة التطبيقات الخاص بـ productionCodePrefix
: PRO وAUO وغيرها من بادئة نوع اجتماع محددة مسبقًا في Webex.
بعد هذا التحسين الجديد، ستستجيب واجهة API للعنصر الجديد من subProdctCodePrefix
:PRO1 وPRO2، وما إلى ذلك والذي يمكن تخصيصه بادئة نوع الاجتماع.
تغييرات المخطط على واجهة برمجة التطبيقات: نوع الاجتماع اللاسلكي
وسوف يستجيب لعنصر جديد: subProdctCodePrefix
مثال على طلب واجهة برمجة التطبيقات والاستجابة لها
طلب والاستجابة لواجهة برمجة التطبيقات 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:meetingType>
<mtgtype:productCodePrefix>PRO</mtgtype:productCodePrefix>
<mtgtype:subProductCodePrefix>PRO3</mtgtype:subProductCodePrefix> //عنصر جديد لنوع الاجتماع المخصص
<mtgtype:active>تم التنشيط</mtgtype:active>
<mtgtype:name>جus_جhat_مغلق </mtgtype:name>
Cus_جhat_تم الإغلاق </mtgtype: displayName>
تحديثات API 41.11.0
تحديثات واجهة برمجة تطبيقات XML 41.11.0
تدعم واجهة برمجة تطبيقات XML التوافق الأمامي في واجهة برمجة تطبيقات إدارة المستخدمين للمواقع المدارة في مركز التحكم
واجهات برمجة التطبيقات المتأثرة وتغييرات المخطط
إذا كان تطبيق التكامل الخاص بك يستخدم حاليا واجهات برمجة تطبيقات إدارة المستخدمين Webex XMLAPI: CreateUser
، وSetUser
، وDelUser
، وGetUser
لتوفير أو إدارة المستخدمين، بعد تحويل موقع Webex الكلاسيكي الخاص بك إلى موقع يديره Control Hub، ستستمر واجهات API هذه في العمل من أجل التوافق مع إعادة التوجيه. هناك بعض التغييرات في السلوك كما هو موضح أدناه:
-
عند استخدام createUser- إذا لم تكن حالة المستخدم في مركز التحكم "نشطة"، فلن تكون حالة المستخدم على الموقع نشطة. إذا كانت حالة المستخدم في مركز التحكم نشطة، فإن حالة المستخدم على الموقع نشطة أيضا، راجع ما يلي: حالة مستخدم المستخدمين الجدد والمحولين في Control Hub.
-
سيتم تجاهل عنصر كلمة المرور في واجهات برمجة تطبيقات CreateUser و SetUser ، ونبدأ في إرسال بريد إلكتروني للتنشيط إلى مستخدمين جدد ، ويمكن للمستخدمين النقر فوق الرابط الموجود في البريد الإلكتروني إلى حساب جديد نشط وإدخال كلمة مرور جديدة.
-
سيتم تجاهل العنصر النشط في CreateUser API ، ولا يمكن تنشيط المستخدم الجديد (لم يتم التحقق منه) من خلال هذه المعلمة باستخدام SetUser API.
-
يجب أن تكون قيمة عنصر webExId في النص الأساسيمحتوى واجهات برمجة تطبيقات CreateUser هي نفسها مثل البريد الإلكتروني. إذا كان webExId مختلفًا عن البريد الإلكتروني، فسنعامل webExId بنفس طريقة البريد الإلكتروني عند تخزينه في WebDB وسيتم تجاهل القيمة.
-
يجب أن تكون قيمة عنصر webExId في bodyContent الخاص بواجهات SetUser هي هوية مستخدم لعنوان البريد الإلكتروني، يمكنك تغييره باستخدام <email> في bodyContent.
-
ستدعم واجهة برمجة تطبيقات SetUser تغيير البريد الإلكتروني للمستخدم الحالي: يكون ناجحا إذا كان حساب العملية في SecurityContext هو مسؤول موقع Control Hub الكامل. وإلا، فإن واجهة برمجة التطبيقات تبلغ عن خطأ باستخدام رمز الخطأ والرسالة الجديدين أدناه:
-
030120 يجب أن يكون الحساب مسؤولاً كاملاً عن الموقع من أجل تغيير البريد الإلكتروني.
-
-
سيتم تجاهل العنصر newWebExId في النص الأساسيمحتوى واجهة برمجة تطبيقات SetUser.
-
تحاول واجهة برمجة تطبيقات SetUser التغيير إلى بريد إلكتروني قيد الاستخدام بالفعل، وتثير واجهة برمجة التطبيقات أسفل رمز الخطأ الجديد ورسالة الخطأ:
-
البريد الإلكتروني 030118 مستخدم بالفعل في المواقع التي يديرها Control Hub.
-
-
تقوم واجهة برمجة تطبيقات DelUser بإلغاء تنشيط المستخدم في جانب اجتماع Webex وتتم إزالة ترخيص الاجتماع المقابل من موقع Webex. يمكن إعادة تنشيط هذا المستخدم الذي تم إلغاء تنشيطه باستخدام واجهة برمجة التطبيقات: تعيينUser (تم تنشيطه) طالما تم التحقق من المستخدم من قبل.
-
تثير واجهات برمجة تطبيقات CreateUser وSetUser رمز خطأ ورسالة خطأ جديدين كما هو موضح أدناه:
-
030117، هذا المستخدم موجود خارج مؤسستك، لذا يجب المطالبة بضمه، لينتقل إلى مؤسستك من خلال عملية المطالبة بضم مستخدم. لمعرفة الخطوات المتعلقة بالمطالبة بالمستخدم في مؤسستك، راجع المطالبة بالمستخدمين إلى مؤسستك (تحويل المستخدمين). ستحتاج إلى إثبات ملكية النطاق الذي ينتمي إليه المستخدم قبل المطالبة بملكية المستخدم.
-
030119 يجب أن يتضمن رمز الوصول إلى CI النطاق webexsquare: المسؤول عند إدارة حسابات المستخدم.
-
يتم دعم التوافق الأمامي لفترة محدودة فقط. سنقدم إشعارا مسبقا قبل إزالة هذا التوافق.
تغييرات المخطط
لا توجد تغييرات في المخطط على واجهات برمجة التطبيقات هذه: CreateUser
، وSetUser
، وDelUser
، وGetUser
.
مثال على طلب واجهة برمجة التطبيقات والاستجابة لها
طلب والاستجابة لواجهة برمجة التطبيقات CreateUser
طلب واجهة برمجة التطبيقات:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:serv="http://www.webex.com/schemas/2002/06/service"
xsi:schemaLocation="http://www.webex.com/schemas/2002/06/service http://www.webex.com/schemas/2002/06/service/service.xsd">
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{حساب مسؤول الموقع}</webExID>
<email>{حساب مسؤول الموقع}</email>
<sessionTicket>xxxx</sessionTicket> أو أو
أو ، عند استخدام CI "accessToken"، يجب أن يتضمن نطاق webexsquare:admin عند توفير المستخدم
</securityContext>
<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/></head><body dir="rtl">
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<webExId>Jack@qa.webex.com</webExId> --- يجب أن يكون معرّف مستخدم عنوان البريد الإلكتروني
<email>Jack@qa.webex.com</email>
<firstName>جاك</firstName>
<lastName>سميث</lastName>
<password>....</password>
<privilege>
<host>true</host>
</privilege>
<active>تم التنشيط</active> --- لا يمكن لهذه المعلمة تنشيط المستخدم مباشرةً حتى يقوم المستخدم بتنشيط نفسه ذاتيًا عن طريق البريد الإلكتروني الخاص بالتنشيط.
</bodyContent>
</body>
مثال على استجابة API:
<?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: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.
-
بالنسبة للمستخدمين الجدد الذين تم إنشاؤهم في المواقع المدارة في مركز التحكم، يجب أن تكون قيمة عنصر webExID هي نفسها قيمة البريد الإلكتروني لتسجيل الدخول.
{siteName}
{userName} --- تم إنشاء المستخدمين الحاليين في موقع webEx الكلاسيكي، ويمكن أن يكون: jack أو jack@xx.com؛ يجب أن يستخدم المستخدم الجديد jack@xx.com
xxxx أو أو أو
التأثير على واجهات برمجة التطبيقات:
جميع واجهات برمجة تطبيقات XML.
بعد تحويل موقع Webex الكلاسيكي إلى موقع مُدار من قبل Control Hub، يجب أن تكون قيمة عنصر <bodyContent> هي نفس قيمة البريد الإلكتروني، وتتضمن التفاصيل التالية:
-
بالنسبة للمستخدمين الحاليين الذين تم إنشاؤهم في موقع Webex الكلاسيكي، نحن ندعم كلاً من webExId القديم (على سبيل المثال: Jack) و webExId الجديد (المحتوى هو نفسه البريد الإلكتروني، على سبيل المثال: Jack@xx.com) في bodyContent.
-
بالنسبة للمستخدمين الجدد الذين تم إنشاؤهم في المواقع التي يديرها Control Hub، يجب أن تكون قيمة عنصر webExId هي نفسها قيمة البريد الإلكتروني في
bodyContent
.
xxxx --- تم إنشاء المستخدمين الحاليين في موقع webEx الكلاسيكي، ويمكن أن يكون: jack أو jack@xx.com؛ يجب أن يستخدم المستخدم الجديد jack@xx.com
التأثير على واجهات برمجة التطبيقات: GetUser
، وSetUser
، وDelUser
.
تغييرات المخطط
لا توجد تغييرات في المخطط على أي واجهات برمجة تطبيقات.
مثال على طلب واجهة برمجة التطبيقات والاستجابة لها
طلب والاستجابة لواجهة برمجة تطبيقات GetUser
طلب واجهة برمجة التطبيقات:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:serv="http://www.webex.com/schemas/2002/06/service"
xsi:schemaLocation="http://www.webex.com/schemas/2002/06/service http://www.webex.com/schemas/2002/06/service/service.xsd">
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> --- تم إنشاء المستخدمين الحاليين في موقع webEx الكلاسيكي، ويمكن أن يكون: jack أو jack@xx.com؛ يجب على المستخدم الجديد استخدام jack@xx.com
xxxx أو أو أو
xxxx --- تم إنشاء المستخدمين الحاليين في موقع webEx الكلاسيكي، ويمكن أن يكون: jack أو jack@xx.com؛ يجب أن يستخدم المستخدم الجديد jack@xx.com
مثال استجابة API:
...نفس الشيء الذي كان عليه من قبل
تحسين تسجيل عرض سجل واجهة برمجة التطبيقات لدعمه في اجتماعات Webex وأحداث Webex (جديدة) وأحداث Webex (كلاسيكية)
واجهات برمجة التطبيقات المتأثرة
واجهة برمجة التطبيقات الحالية: يدعم lstrecordaccessHistory
وlstrecordaccessDetailHistory
فقط عرض تسجيل التدريبات في Webex تقرير محفوظات الوصول. يدعم التحسين الجديد اجتماعات Webex وأحداث Webex (جديدة) وأحداث Webex (الكلاسيكية) لعرض تقرير السجل الذي تم الوصول إليه أيضا.
تغييرات المخطط
نحن ندعم أدناه المخطط الجديد في API lstrecordaccessHistory في نص طلب واجهة برمجة التطبيقات:
MeetingCenter
TrainingCenter
EventCenter
التفاصيل
واجهة برمجة التطبيقات: lstrecordaccessHistory
قادر على إرجاع عرض التسجيل الذي تم الوصول إليه من أجل Webex Meetings وWebex Events (الجديد) وWebex Events (الكلاسيكي) وWebex Trainings.
-
إذا لم يتم تحديد serviceType في طلب API، فإن واجهة API الخاصة بـ
lstrecordaccessHistory
ترجع عرض تسجيل Webex Trainings الذي تم الوصول إليه فقط. -
عندما يكون serviceType هو MeetingCenter، تقوم واجهة API الخاصة بـ
lstrecordaccessHistory
بإرجاع كلاً من عرض تسجيل Webex Meetings وWebex Events (الجديد) الذي تم الوصول إليه. -
عندما يكون serviceType هو EventCenter، تقوم واجهة API الخاصة بـ
lstrecordaccessHistory
بإرجاع عرض تسجيل Webex Events (الكلاسيكي) الذي تم الوصول إليه.
واجهة برمجة التطبيقات: يستطيع lstrecordaccessDetailHistory
إرجاع التفاصيل عن طريق recordID
الخاصة بتطبيق Webex Meetings وWebex Events (الجديد) وWebex Events (الكلاسيكي) وWebex Trainings.
مثال على طلب واجهة برمجة التطبيقات والاستجابة لها
طلب واجهة برمجة التطبيقات lstrecordaccessHistory
والاستجابة لها
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<securityContext>
<webExID>{userName}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.history.LstrecordaccessHistory">
<viewTimeScope>
<viewTimeStart>9/20/2021 00:00:00</viewTimeStart>
<viewTimeEnd>9/28/2021 23:59:59</viewTimeEnd>
</viewTimeScope>
<listControl>
<startFrom>1</startFrom>
<maximumNum>100</maximumNum>
</listControl>
<orderBy>تم التسجيل</orderBy>
<orderAD>ASC</orderAD>
<serviceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>مركز التدريب</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>09/24/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>الاختبارrollment_001-20210610 1905-1</history:recordName>
<history:creationTime>10/06/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>07/05/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>09/22/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 EC2.0-20210924 1315-1</history:recordName>
<history:creationTime>09/24/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 MC-20210924 1319-1</history:recordName>
<history:creationTime>09/24/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 الكلاسيكي EC-20210924 1331-1</history:recordName>
<history:creationTime>09/24/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">
<securityContext>
<webExID>{userName}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>
<body>
<bodyContent xsi:type=
"java:com.webex.service.binding.history.LstrecordaccessDetailHistory">
<recondID>1XXXXXX7</recondID>
<timeZoneID>20</timeZoneID>
</bodyContent>
<?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:lstrecordaccessDetailHistoryResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<history:recordDetail>
<history:viewID>1XXXXXX7</history:viewID>
<history:participantName>Axxxg</history:participantName>
<history:participantEmail>Axxxg@qa.webex.com</history:participantEmail>
<history:accessTime>09/24/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:recordDetail>
<history:viewID>1XXXXXX7</history:viewID>
<history:participantName>Axxxg</history:participantName>
<history:participantEmail>Axxxg@qa.webex.com</history:participantEmail>
<history:accessTime>09/24/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>
</serv:bodyContent>
التأثير على واجهات برمجة التطبيقات:
-
lstrecordaccessHistory
-
lstrecordaccessDetailHistory
قم بإصلاح الفجوة في الحد الأقصى المسموح به لطول وصف أحداث Webex (الكلاسيكية) بين XMLAPI وصفحة Webex.
واجهات برمجة التطبيقات المتأثرة
واجهة برمجة تطبيقات XML: سيسمح 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>خاص</listing>
</accessControl>
<metaData>
<sessionName>اختبار EC</sessionName>
<description>...... نفترض أنك قمت بتعبئة 10000 حرف في الوصف.......</description>
</metaData>
...
------------------------------------
#مثال استجابة API عندما يتجاوز الوصف 10000 حرف:
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:result>فشل</serv:result>
وصف إدخال غير قانوني. لا يمكن أن يتجاوز الوصف 10000 حرف
PRIMARY
060068
التأثير على واجهات برمجة التطبيقات:
-
كريت إيفنت
-
سيت إيفنت
واجهة برمجة تطبيقات XML: GetUser بإرجاع عنصر جديد من الحساب المجاني
واجهات برمجة التطبيقات المتأثرة
يقوم GetUser
بإرجاع عنصر جديد يحددfreeAccount
إذا كان حساب المستخدم FreeAccount
أم لا.
تغييرات المخطط
مثال على استجابة GetUser
استجابة
GetUser:
AW
false
3
false
التأثير على واجهات برمجة التطبيقات:
GetUser
تحديثات API 41.10.0
لا توجد تغييرات في المخطط على مخطط XML API 41.10.0.
تحديثات API 41.9.0
تحديثات واجهة برمجة تطبيقات XML 41.9.0
إيقاف تشغيل واجهة برمجة تطبيقات XML 10.0.0 لجميع مواقع T31
تخطط Webex لنهاية دعم الحياة XML API ver 10.0.0 لجميع مواقع T31.
نحن بصدد إيقاف تشغيل رمز XML API 10.0.0 من جميع عمليات الإنتاج في التحديث 41.9.0.
تحديثات API 41.8.0
تحديثات واجهة برمجة تطبيقات XML 41.8.0
إيقاف تشغيل واجهة برمجة تطبيقات XML 10.0.0 لجميع مواقع T31
تخطط Webex لنهاية دعم الحياة XML API ver 10.0.0 لجميع مواقع T31.
عثر Webex على بعض العملاء الذين يصلون إلى عنوان URL الخاص بواجهة برمجة تطبيقات XML باستخدام طريقة غير صحيحة على النحو التالي: https://{siteName}.webex.com/WBXService/xml10.0.0/XMLService ، الطريقة الصحيحة للوصول إلى عنوان URL لواجهة برمجة تطبيقات XML على النحو التالي: https://{siteName}.webex.com/WBXService/XMLService.
يرجى تبديل واجهة برمجة تطبيقات XML للوصول إلى التعليمات البرمجية باستخدام الطريقة الصحيحة لتجنب التأثير قبل انتهاء دعم العمر الافتراضي على الإصدار 10.0.0 من واجهة برمجة تطبيقات XML.
تحديثات API 41.7.0
تحديثات واجهة برمجة تطبيقات XML 41.7.0
يجب التحكم في حذف وتحرير التسجيل عبر الهاتف المحمول بواسطة خيار إدارة الموقع: السماح للمضيفين بإعادة تعيين التسجيلات وتعديلها وتعطيلها وحذفها
واجهات برمجة التطبيقات المتأثرة وتغييرات المخطط
الحصول على الموقع
: سيتم إرجاع عناصر جديدة تحمل التسمية enableNBRMCModify
، وseparateNoRecordingEdit
ضمن الأدوات.
مثال على الاستجابة
GetSiteResponse
:
جيت سايت
<?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:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
....
...
<ns1:enableNBRMCModify>false</ns1:enableNBRMCModify>
<ns1:separateNoRecordingEdit>
...
</ns1:tools>
</serv:bodyContent>
</serv:body>
تحديثات API 41.6.3
تحديثات واجهة برمجة تطبيقات XML 41.6.3
عنصر جديد لاستجابة GetSite
في supportLargeEvent
واجهات برمجة التطبيقات المتأثرة وتغييرات المخطط
الحصول على الموقع: إرجاع عناصر جديدة تحمل الاسم supportLargeEvent
ضمن siteCommonOptions
لإعلام المتصل بما إذا كان الموقع يدعم Large Event (Webex Event (جديد)) أم لا.
تغيير المخطط
مثال على الاستجابة
GetSiteResponse
:
جيت سايت
<?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:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
....
...
<ns1:enablePreMeetingLobby>
<ns1:supportLargeEvent>true</ns1:supportLargeEvent>
</ns1:siteCommonOptions>
</serv:bodyContent>
</serv:body>
تحديثات API 41.6.0
تحديثات واجهة برمجة تطبيقات XML 41.6.0
يدعم XMLAPI Webex Events 2.0 في التوفير
واجهات برمجة التطبيقات المتأثرة
الحصول على المستخدم
: إرجاع عنصر جديد يسمى largeEventCapacity
والذي يوضح سعة Event 2.0 الجديد (EC 2.0) ضمن حساب المستخدم هذا. على سبيل المثال، إذا كان حساب المستخدم لديه ترخيص CI_EC3K، فإن قيمة largeEventCapacity
هي 3000.
تغييرات المخطط
مثال على الاستجابة
GetUserResponse:
يطبق وقت إنشاء XMLAPI LstRecording وقت بدء التسجيل
واجهات برمجة التطبيقات المتأثرة
التسجيل
: استجابة LstRecording
CreateTime
كالوقت الذي يضغط فيه المستخدم فعليًا على زر التسجيل.
التفاصيل
في الماضي، استخدمت XML API الطابع الزمني عند إنشاء التسجيل في قاعدة البيانات باعتباره وقت الإنشاء في استجابة LstRecording
. الآن هو الوقت الذي يبدأ فيه المستخدم بالفعل في إجراء التسجيل. ينطبق هذا التغيير على جميع تسجيلات الخدمة. لا يوجد تغيير في المخطط.
تحديثات API 41.5.0
تحديثات واجهة برمجة تطبيقات XML 41.5.0
XMLAPI لديه القدرة على بدء اجتماعات Webex المجدولة من PSTN كمضيف
واجهات برمجة التطبيقات المتأثرة
-
إنشاء المستخدم:
يقوم بإنشاء
hostPIN
بغض النظر عن تمكين PMR للمستخدم أو عدم تمكين دور المستخدم عندما يكون دور المستخدم هو المضيف أو مسؤولي موقع إدارة المستخدمين بصلاحيات كاملة أو للقراءة فقط أو بصلاحيات للقراءة فقط. -
تعيين المستخدم:
يقوم بتعيين
hostPIN
باستخدامphones.hostPIN
عند عدم وجودpersonalMeetingRoom.hostPIN
في طلب XML (الشرط المسبق: تم تمكين تبديل الميزةAllowStartScheduledMtgFromPhone
). -
الحصول على المستخدم
: ترجعphones.hostPIN
بغض النظر عن تمكين PMR للمستخدم أم لا. (الشرط المسبق: تم تمكين تبديل الميزةAllowStartScheduledMtgFromPhone
).
تغييرات المخطط
GetUserResponse
:
تعيين المستخدم:
مثال على الاستجابة
GetUserResponse
:
تعيين المستخدم:
استجابة XMLAPI GetSite
عنصران جديدان لعميل الأجهزة المحمولة
واجهات برمجة التطبيقات المتأثرة
-
الحصول على الموقع
: سيقومGetSite
الآن بالرد على عنصرين جديدين لدعم عميل الأجهزة المحمولة الذي لديه المنطق اللازم لعرضه أو عدم عرضه علامة تبويب التسجيل.-
تمكينRecordingAccess
: صحيح أو خطأ، يستطيع مسؤولو Webex الفائقون تمكين أو تعطيل الوصول إلى التسجيل عن طريق التبديل (EnableRecordingAccess
). -
storageEmptyStatus
: صحيح أو خاطئ، إذا كان كلا الموقعين لا يدعم وظيفة NBR وخصص مساحة تخزين NBR كصفر، فإن استجابة الحالة تكون صحيحة، وإلا تكون خاطئة.
-
تغييرات المخطط
طلب عينة لـ GetSite
عينة استجابة Getsite
سيتم ترميز موضوع البريد الإلكتروني الذي يحتوي على أحرف غير ASCII باستخدام RFC2047. في حالة وجود موضوع بريد إلكتروني لحرف ASCII خالص ، لا يوجد ترميز
واجهات برمجة التطبيقات المتأثرةلا توجد تأثيرات على أي طلب API ، حمولة الردود ، ولكنها تغير سلوك ترميز موضوع البريد الإلكتروني. عندما يتم ترميز موضوع البريد الإلكتروني الذي يحتوي على أحرف غير ASCII باستخدام RFC2047. في حالة وجود موضوع بريد إلكتروني نقي لحرف ASCII ، لا يوجد ترميز.
تغييرات المخطط
لا توجد تغييرات في المخطط.
تحديثات API 41.4.0
تحديثات واجهة برمجة تطبيقات XML 41.4.0
إنشاء حدث مجدول أحداث Webex يمكن الاستفادة من الإعداد الافتراضي على مستوى الموقع على نغمة الدخول والخروج
يتوافق XMLAPI مع المنطق الجديد الحالي للتحكم في نغمة الدخول والخروج. تم التحكم في جميع نغمات أحداث Webex بواسطة إعداد مختلف في إدارة الموقع. في GetSite
، يرجع XMLAPI حقل إضافي entryExitToneEC
للإشارة إلى القيمة. في الأصل، عندما يقوم مسؤول الموقع بتعيين إعداد افتراضي للنغمة، لن يستفيد إنشاء الحدث من هذا الإعداد من خلال تطبيق XMLAPI الافتراضي.
واجهات برمجة التطبيقات المتأثرة
واجهة برمجة تطبيقات XML: يُرجع GetSite عنصر جديد واحد entryExitToneEC
للإشارة إلى القيمة.
واجهة برمجة تطبيقات XML: يقرأ منطق الأعمال CreateEvent، SetEvent، GetEvent مرة أخرى قيمة entryExitToneEC
.
تغييرات المخطط
واجهة برمجة تطبيقات XML: عينة استجابة GetSite:
<ns1:emailReminders>true</ns1:emailReminders>
<ns1:entryExitTone>الإعلان عن الاسم</ns1:entryExitTone>
<ns1:entryExitToneEC>ملاحظة
<ns1:voip>true</ns1:voip>
<ns1: مكالمة عن بُعد>
<ns1:telephonySupport>لا شيء</ns1:telephonySupport>
</ns1:مكالمة عن بُعد>
<ns1:joinTeleconfNotPress1>true</ns1:joinTeleconfNotPress1>
<ns1:updateTSPAccount>false</ns1:updateTSPAccount>
</ns1:defaults>
التأثير على واجهات برمجة التطبيقات:
-
جيت سايت
-
كريت إيفنت
-
سيت إيفنت
-
جيت إيفنت
يقوم XMLAPI فقط بإرجاع معلومات تفاصيل الحدث الكبير (Webex Event 2.0)
-
إذا كان اجتماع Webex هو الحدث الكبير أو نشرة الويب، فإن
GetSessionInfo
يقوم بإرجاع بعض المعلومات التفصيلية بما في ذلك كلمة مرور الاجتماع وكلمة المرور الرقمية للاجتماع وكلمة مرور عضو اللجنة وكلمة المرور الرقمية لعضو اللجنة (لم يتم تغيير أي مخطط). -
لا يدعم XMLAPI إنشاء وتحرير أي ميزة أحداث أو نشرات ويب كبيرة، لذلك يقوم
CreateMeeting
وSetMeeting
بإرجاع استثناء جديد (110064، لا يتم دعم نوع جلسة الحدث ونشرات الويب.) لحالة الأحداث أو نشرات الويب الكبيرة.
واجهات برمجة التطبيقات المؤثرة
اسم واجهة برمجة التطبيقات |
الوصف |
كلام |
---|---|---|
|
إذا كان اجتماع Webex هو الحدث الكبير أو نشرة الويب، فإن |
لا يمكن تغيير أي مخطط. |
|
إذا حاول المستخدم استخدام واجهة برمجة التطبيقات |
يجب تغيير السلوك. |
تحديثات API 41.3.0
تحديثات واجهة برمجة تطبيقات XML 41.3.0
تدعم التغييرات الجديدة في واجهة برمجة تطبيقات XML ميزة Webex Events 2.0
واجهات برمجة التطبيقات المتأثرة
كل من واجهات برمجة التطبيقات: يقوم GetSessionInfo وGetMeeting بإرجاع العنصرين enableEvent
وenableWebniar
أيضًا.
اسم العنصر |
الوصف |
---|---|
تمكين الحدث |
يدعم EC 2.0 في اجتماع Webex |
تمكين ويبنيار |
يدعم الويبينار في اجتماع Webex |
يعود دعم XMLAPI فوق عنصرين ل EC 2.0. لا يدعم إصدار واجهة برمجة تطبيقات XML الحالي جدولة اجتماع EC2.0 وتعيينه.
تغييرات المخطط
يقوم GetSessionInfo
بإرجاع العنصرين enableEvent
وenableWebniar
لـ EC 2.0.
يقوم GetMeeting
بإرجاع العنصرين enableEvent
وenableWebniar
لـ EC 2.0.
عينة الاستجابة:
استجابة GetSessionInfo
:
عام
false
true
false
false
false
false
true
استجابة GetMeeting
:
false
true
true
true
false
false
true
تدعم تغييرات XMLAPI الجديدة ميزة ردهة الانتظار قبل الاجتماع
واجهات برمجة التطبيقات المتأثرة
واجهة برمجة تطبيقات XML: سيستجيب GetSite
، وLstSummarySession
، وGetSessionInfo
، وGetMeeting
للعنصر الجديد enablePreMeetingLobby
لردهة ما قبل الاجتماع.
تغييرات المخطط
واجهة برمجة تطبيقات XML: يقوم GetSite
بإرجاع العنصر enablePreMeetingLobby
لردهة ما قبل الاجتماع.
واجهة برمجة تطبيقات XML: يقوم LstSummarySession
بإرجاع العنصر enablePreMeetingLobby
لردهة ما قبل الاجتماع.
واجهة برمجة تطبيقات XML: يقوم GetSessionInfo
بإرجاع العنصر enablePreMeetingLobby
من أجل ردهة ما قبل الاجتماع.
واجهة برمجة تطبيقات XML: يقوم GetMeeting
بإرجاع العنصر enablePreMeetingLobby
لردهة ما قبل الاجتماع.
عينة الاستجابة:
استجابة GetSite
:
false
false
false
true
true
true
true
false
true
true
استجابة LstSummarySession
:
false
true
0
false
false
false
true
استجابة GetSessionInfo
:
عام
false
true
false
false
false
false
true
استجابة GetMeeting
:
false
true
true
true
false
false
true
كشف تغيير سلوك معلومات استجابة GetSite
XML API
واجهات برمجة التطبيقات المتأثرة
واجهة برمجة تطبيقات XML: استجابة GetSite
فقط فيما يلي العناصر الخاصة بحساب المسؤول، والتي تتضمن الأدوار: SiteAdmin
، وRO_SiteAdmin
، وUserAdmin
.
...
...
...
...
...
تغير السلوك
السماح لدور المسؤول فقط بالحصول على بيانات ترخيص استجابة من GetSite
. لن يحصل المضيف أو الحاضر على بيانات هذه التراخيص في استجابة GetSite
.
فيما يلي واجهة برمجة التطبيقات: مثال على استجابة GetSite
من أجل مسؤول الموقع
أو مسؤول الموقع
جاهز فقط أو مسؤول إدارة المستخدم:
تحديثات API 41.2.0
تحديثات واجهة برمجة تطبيقات XML 41.2.0
يجب أن يدعم XMLAPI "CMR Hybrid VOIP" إذا كان الموقع يدعم الاتصال الهاتفي Webex
واجهات برمجة التطبيقات المتأثرة
-
يُرجع
GetSite
عنصر جديدIsWebexTelephony
في الاستجابة. -
يمكن لـ
CreateUser
وSetUser
تحديث عنصرcmrHybridVoip
إذا كانتIsWebexTelephony
صحيحة بالإضافة إلى شروط أخرى. لم يعدIsTSPUsingTelephonyAPI
ذا تأثير.
تغييرات المخطط
واجهة برمجة تطبيقات XML: ترجع استجابة GetSite
عنصرًا إضافيًا IsWebexTelephony
تتضمن استجابة GetSite
هذا العنصر الجديد:
<ns1:isWebexTelephony>true</ns1:isWebexTelephony>
<ns1:isTSPUsingTelephonyAPI>false</ns1:isTSPUsingTelephonyAPI>
<ns1:serviceName>رقم المؤتمر الشخصي</ns1:serviceName>
<ns1:participantAccessCodeLabel>رمز وصول الحاضر</ns1:subscriberAccessCodeLabel>
<ns1:subscriberAccessCodeLabel>
<ns1:attendeeIDLabel>معرف الحاضر</ns1:attendeeIDLabel>
....
</ns1:telephonyConfig>
يدعم LstSummarySession
EC2.0
تتأثر واجهات برمجة تطبيقات XML
سيقوم LstSummarySession
بإرجاع عنصرين جديدين لدعم EC 2.0
اسم العنصر |
الوصف |
---|---|
تمكين الحدث |
يدعم EC 2.0 في اجتماع Webex |
تمكين ويبنيار |
يدعم الويبينار في اجتماع Webex |
تغييرات المخطط
واجهة برمجة تطبيقات XML: LstSummaryالجلسة
:إلحاق بعناصر <enableEvent
> و<enableWebniar
>
استجابة واجهة برمجة تطبيقات XML: LstSummaryالجلسة
الرد على EC 2.0
true
0
false
true
true
يدعم XMLAPI إرجاع خيار Webex-voice-assistant
لمستخدم الموقع من أجل دمج MCT
واجهة برمجة التطبيقات المتأثرة
يقوم GetUser
بإرجاع عنصر جديد webexAssistantEnabled
(صحيح أو false) في الاستجابة.
تغييرات المخطط
getUserResponse:
مثال على الاستجابة
تحديثات API 41.1.0
لا توجد تغييرات في المخطط على مخطط XML API 41.1.