الأذونات التي تطلبها إضافة Webex ل G Suite

أذونات حساب المستخدم

لقطة شاشة للأذونات التي يطلبها Webex عند تمكين المجدول من الاتصال بحسابك على Google — الشكل رقم 1. Webex يطلب هذه الأذونات

الجدول رقم 1. الأذونات المطلوبة وكيفية استخدام Webex لها
الإذن	النطاق	البيانات التي تم الوصول إليها	ما الذي يستخدمه Webex من أجله؟
عرض بيانات تعريف رسالة البريد الإلكتروني عند تشغيل الوظيفة الإضافية	جيميل	سطر الموضوع، التاريخ والوقت، قائمة المدعوين	عند جدولة اجتماع Webex في Gmail، يقرأ المجدول هذه المعلومات، وهي المتطلبات الأساسية لجدولة الاجتماع.
التشغيل كإضافة Gmail	جيميل	—	يسمح هذا الإعداد بتشغيل Webex Scheduler في Gmail الخاص بالمستخدم.
الاطلاع على الأحداث التي تفتحها في تقويم Google	التقويم	سطر الموضوع، التاريخ والوقت، قائمة المدعوين	عند فتح حدث في تقويم Google، يقرأ المجدول هذه المعلومات، وهي المتطلبات الأساسية لجدولة الاجتماع.
تعديل الأحداث التي تفتحها في تقويم Google	التقويم	سطر الموضوع	أضف معلومات بيانات مؤتمر Webex (واجهة مستخدم البطاقة/مكان الإقامة) إلى حدث التقويم المفتوح الحالي.
التشغيل كوظيفة إضافية للتقويم	التقويم	—	يسمح بتشغيل Webex Scheduler في تقويم Google الخاص بالمستخدم
عرض الأحداث وتحريرها في جميع التقاويم	التقويم	قراءة سطر الموضوع والتاريخ والوقت وقائمة المدعوين تحرير سطر الموضوع	يسمح لنا بدعم سيناريوهات التقويم المشتركة، بنفس الطريقة التي نقرأ بها الأحداث ونكتب إليها في تقويم مستخدم واحد.
عرض إعدادات التقويم	التقويم	—	يتطلب Google OAuth 2.0 هذا النطاق. انظر https://developers.google.com/calendar/api/guides/auth.
الاطلاع على معلومات حول المستخدمين على نطاقك	مشرف G Suite	Webex siteURL في معلومات مستخدم Google	إذا قمت بتعيين عنوان URL لموقع Webex في معلومات مستخدم Google ، فيمكننا قراءة عنوان URL هذا وتسجيل الدخول إلى هذا الموقع كعنوان افتراضي للمستخدم.
الاتصال بخدمة خارجية	البرنامج النصي للتطبيقات	الاتصال بخدمة Webex	يحتاج المجدول إلى استدعاء خدمة Webex لطلب إنشاء/تحديث/حذف اجتماع Webex المقترن.
السماح لهذا التطبيق لتشغيل عندما كنت غير موجود	البرنامج النصي للتطبيقات	الوصول إلى كائن حدث Google استنادا إلى مشغل Google	يسمح هذا بتشغيل Scheduler عندما لا تكون موجودا ، استجابة لمشغل Google ، على سبيل المثال لتحديث / حذف اجتماع في التقويم الخاص بك. انظر https://developers.google.com/apps-script/guides/triggers/events.
عرض وإدارة البيانات المرتبطة بالتطبيق	البرنامج النصي للتطبيقات	ذاكرة التخزين المؤقت للتطبيق	يقوم المجدول بتخزين بعض معلومات Webex مؤقتا في مساحة تخزين Google. على سبيل المثال، عنوان URL لموقع Webex وقالب اجتماع Webex.
عرض بلدك ولغتك ومنطقتك الزمنية	البرنامج النصي للتطبيقات	الوقت الحالي للمستخدم	يقرأ المجدول منطقتك الزمنية لجدولة اجتماع Webex المرتبط أو تحديثه
الاطلاع على عنوان البريد الإلكتروني الأساسي لحسابك على Google	أخرى	عنوان حساب Gmail للمستخدم	يقرأ المجدول عنوان البريد الإلكتروني للمستخدم لربطه بحساب Webex الخاص به.
الاطلاع على معلوماتك الشخصية، بما في ذلك أي معلومات شخصية قمت بإتاحتها للجمهور	أخرى	اسم المستخدم ولغته المفضلة (افتراضي)	يقرأ المجدول معلومات المستخدم العامة للمستخدم، بما في ذلك الاسم الكامل، واللغة المفضلة لاستخدامها كلغة افتراضية للمستخدم.

نظرة عامة على بنية Webex Scheduler

رسم تخطيطي للبنية يعرض سحابة Google وسحابة Webex وعميل تقويم Google، مع وجود أسهم مرقمة تربطها.

يستخدم مشرف موقعك إدارة الموقع أو مركز التحكم لتمكين الوظيفة الإضافية Webex ل Google Workspace.
يأذن كل فرد بالأذونات للوظيفة الإضافية Webex ل G Suite (إذا لم يفوض مشرفك) ويربط حسابه على Google بحسابه على Webex.
يشترك Webex في تغييرات التقويم من Google.
يضيف المستخدم اجتماع Webex إلى حدث في تقويم Google، أو يحدث الوقت أو الموضوع، أو ينسخ حدثا إلى تاريخ ووقت آخرين.
يتلقى عميل Webex الإضافي إشعارات تقويم Google ويتزامن مع Webex.

واجهات برمجة تطبيقات Google المستخدمة من قبل Webex Scheduler

توفر الجداول أدناه معلومات حول واجهات برمجة تطبيقات Google التي يستخدمها Webex Scheduler.

بالنسبة لمعظم الحالات، يستخدم Webex Scheduler واجهة برمجة تطبيقات Google App Script. في بعض الحالات، يستخدم المجدول واجهة برمجة تطبيقات Google REST. بشكل عام ، تقوم واجهة برمجة تطبيقات Google App Script بتغليف واجهة برمجة تطبيقات Google REST المقترنة. يشير عمود عنوان URL المرجعي إلى واجهة برمجة تطبيقات Google App Script API حيثما أمكن ذلك، ولكنه قد يشير إلى عنوان URL المرجعي لواجهة برمجة تطبيقات Google REST إذا لزم الأمر.

الجدول رقم 2. واجهات برمجة تطبيقات البرامج النصية لتطبيقات Google المستخدمة بواسطة Webex Scheduler
واجهة برمجة تطبيقات البرنامج النصي لتطبيقات Google	ما يفعله	عنوان URL المرجعي
Calendar.getID	الحصول على معرف تقويم المستخدم، معرف التقويم الافتراضي هو عنوان البريد الإلكتروني للمستخدم	https://developers.google.com/apps-script/reference/calendar/calendar#getId()
Calendar.getName	الحصول على اسم التقويم	https://developers.google.com/apps-script/reference/calendar/calendar#getName()
Calendar.getTimezone	الحصول على المنطقة الزمنية للتقويم	https://developers.google.com/apps-script/reference/calendar/calendar#getTimeZone()
Calendar.Events.list	البحث عن أحداث محددة تتطابق مع بعض المعايير	https://developers.google.com/calendar/api/v3/reference/events/list
Calendar.Events.patch	تحديث بيانات تعريف الحدث المحددة لتخزين معلومات اجتماع webex	https://developers.google.com/calendar/api/v3/reference/events/patch
CalendarEvent.attendees	خصائص الوصول إلى الحاضرين في التقويم	https://developers.google.com/calendar/api/v3/reference/events#resource
CalendarEvent.conferenceData	الخصائص اللازمة للوصول إلى بيانات مؤتمر الحدث	https://developers.google.com/calendar/api/v3/reference/events#resource
CalendarEvent.getTitle	احصل على موضوع حدث التقويم.	https://developers.google.com/apps-script/reference/calendar/calendar-event#getTitle()
CalendarEvent.getCreators	الحصول على منشئ حدث التقويم	https://developers.google.com/apps-script/reference/calendar/calendar-event#getCreators()
CalendarEvent.getStartTime	الحصول على وقت بدء الحدث	https://developers.google.com/apps-script/reference/calendar/calendar-event#getStartTime()
CalendarEvent.getEndTime	الحصول على وقت انتهاء الحدث	https://developers.google.com/apps-script/reference/calendar/calendar-event#getEndTime()
CacheService.getUserCache	الحصول على ذاكرة التخزين المؤقت للمستخدم لاسترداد إعدادات تفضيلات المستخدم	https://developers.google.com/apps-script/reference/cache/cache-service#getUserCache()
ذاكرة التخزين المؤقت.الحصول على	الحصول على إعداد ذاكرة التخزين المؤقت المحددة حسب المفتاح	https://developers.google.com/apps-script/reference/cache/cache#get(String)
Cache.put	تعيين بعض ذاكرة التخزين المؤقت المحددة حسب المفتاح	https://developers.google.com/apps-script/reference/cache/cache#put(سلسلة، سلسلة)
خدمة بيانات المؤتمر. newConferenceDataBuilder	إنشاء بنية بيانات خاصة ب Google لتخزين معلومات اجتماع webex وعرضها	https://developers.google.com/apps-script/reference/conference-data/conference-data-service#newConferenceDataBuilder()
ConferenceDataBuilder.build	إنشاء بيانات معلومات اجتماع webex	https://developers.google.com/apps-script/reference/conference-data/conference-data-builder#build()
GmailApp.getMessageById	استرداد رسالة Gmail المحددة	https://developers.google.com/apps-script/reference/gmail/gmail-app#getMessageById(String)
GmailApp.createDraft	إنشاء رسالة Gmail تحتوي على نص البريد الإلكتروني webex	https://developers.google.com/apps-script/reference/gmail/gmail-app#createDraft(سلسلة، سلسلة، سلسلة)
GmailMessage.getمن	الحصول على البريد الإلكتروني لمرسل Gmail	https://developers.google.com/apps-script/reference/gmail/gmail-message#getFrom()
GmailMessage.getTo	احصل على جهاز استقبال جميل	https://developers.google.com/apps-script/reference/gmail/gmail-message#getTo()
GmailMessage.getSubject	الحصول على عنوان رسالة Gmail	https://developers.google.com/apps-script/reference/gmail/gmail-message#getSubject()
GmailMessage.getDate	الحصول على تاريخ ووقت رسالة Gmail	https://developers.google.com/apps-script/reference/gmail/gmail-message#getDate()
PropertiesService.getUserProperties	الوصول إلى استمرارية المستخدم المستمر أو الإعداد	https://developers.google.com/apps-script/reference/properties/properties-service#getUserProperties()
Properties.getProperty	الحصول على خاصية محددة عن طريق المفتاح	https://developers.google.com/apps-script/reference/properties/properties#getProperty(String)
Properties.setProperty	تعيين خاصية جديدة للمفتاح والقيمة	https://developers.google.com/apps-script/reference/properties/properties#setProperty(سلسلة,سلسلة)
Session.getEffectiveUser().getEmail	الحصول على البريد الإلكتروني الحالي للمستخدم	https://developers.google.com/apps-script/reference/base/user#getEmail()
ScriptApp.newTrigger	إعداد مشغل جديد للتعامل مع تحديث الحدث	https://developers.google.com/apps-script/reference/script/script-app#newTrigger(String)
UrlFetchApp.fetch	استخدم واجهة برمجة التطبيقات هذه للاتصال بخدمة Webex Addin أو google API لإنشاء / تحديث الاجتماع ، ولن نتصل بأي خدمة طرف 3rd أخرى	https://developers.google.com/apps-script/reference/url-fetch/url-fetch-app#fetch(String)

الجدول رقم 3. واجهات برمجة تطبيقات Google REST المستخدمة بواسطة Webex Scheduler
جوجل بقية API	ما يفعله	عنوان URL المرجعي
ما بعد https://accounts.google.com/o/oauth2/token	الحصول على الرمز المميز لمصادقة Google	https://developers.google.com/identity/protocols/oauth2/web-server#exchange-authorization-code
GET https://www.googleapis.com/admin/directory/v1/users/{userKey}	الحصول على موقع Webex للمستخدم الذي تم تكوينه	https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/get

أسئلة متكررة

كيف يقوم Webex بتأمين التكامل؟

يتم تشغيل الوظيفة الإضافية على خادم الأنظمة الأساسية السحابية من Google ، ولا يتم حفظ بيانات Google باستثناء معلومات اجتماع Webex (الموضوع ، قائمة المدعوين) التي يتم تخزينها في الواجهة الخلفية ل Webex وحذفها بعد انتهاء اجتماع مجدول.

انظر https://help.webex.com/ituhp0.

كيف يمكننا تأمين بيانات العملاء التي "نسحبها" من هذا التكامل؟

نحن نجمع فقط البيانات التي نحتاجها ، ونخزنها فقط طالما أننا بحاجة إلى ذلك.

نقوم بجمع معلومات اجتماع Webex وتخزينها في سحابة Webex. نقوم بحذف معلومات الاجتماع بعد فترة زمنية معينة، والتي تتحكم فيها باستخدام سياسة الاحتفاظ بالبيانات في Webex الخاصة بك.

هل نستخدم واجهة برمجة تطبيقات عامة أو خاصة للاتصال بخدمة Google؟

يعمل Addon على منصة Google السحابية والوصول إلى مكتبات Google المضمنة مباشرة.

انظر https://developers.google.com/apps-script/overview.