الأذونات التي تطلبها إضافة Webex ل G Suite
أذونات حساب المستخدم
الإذن |
النطاق |
البيانات التي تم الوصول إليها |
ما الذي يستخدمه 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
-
يستخدم مشرف موقعك إدارة الموقع أو مركز التحكم لتمكين الوظيفة الإضافية 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 إذا لزم الأمر.
واجهة برمجة تطبيقات البرنامج النصي لتطبيقات Google |
ما يفعله |
عنوان URL المرجعي |
---|---|---|
التقويم.getID |
الحصول على معرّف تقويم المستخدم، معرّف التقويم الافتراضي هو عنوان البريد الإلكتروني للمستخدم |
https://developers.google.com/apps-script/reference/calendar/calendar#getId() |
التقويم.getName |
الحصول على اسم التقويم |
https://developers.google.com/apps-script/reference/calendar/calendar#getName() |
التقويم.getالمنطقة الزمنية |
احصل على المنطقة الزمنية للتقويم |
https://developers.google.com/apps-script/reference/calendar/calendar#getTimeZone() |
التقويم.Events.list |
ابحث عن أحداث معينة تتطابق مع بعض المعايير |
https://developers.google.com/calendar/api/v3/reference/events/list |
التقويم.Events.patch |
تحديث بيانات تعريف الحدث المحدد لتخزين معلومات اجتماع webex |
https://developers.google.com/calendar/api/v3/reference/events/patch |
CalendarEvent.الحضور |
الخصائص اللازمة للوصول إلى الحضور في التقويم |
https://developers.google.com/calendar/api/v3/reference/events#resource |
التقويمEvent.conferenceData |
خصائص الوصول إلى بيانات مؤتمر الحدث |
https://developers.google.com/calendar/api/v3/reference/events#resource |
التقويمEvent.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() |
التقويمEvent.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() |
ذاكرة التخزين المؤقتService.getUser |
الحصول على ذاكرة التخزين المؤقت للمستخدم من أجل استرداد إعدادات تفضيلات المستخدم |
https://developers.google.com/apps-script/reference/cache/cache-service#getUserCache() |
التخزين المؤقت.get |
الحصول على إعداد ذاكرة تخزين مؤقت محدد حسب المفتاح |
https://developers.google.com/apps-script/reference/cache/cache#get(String) |
ذاكرة التخزين المؤقت.put |
تعيين بعض ذاكرة التخزين المؤقت محددة باستخدام المفتاح |
https://developers.google.com/apps-script/reference/cache/cache#put(String,String) |
ConferenceDataService. newConferenceDataBuilder |
إنشاء هيكل بيانات خاص بـ Google لتخزين معلومات اجتماع webex وعرضها | |
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.createمسودة |
إنشاء رسالة Gmail تحتوي على نص البريد الإلكتروني الخاص بـ webex | |
GmailMessage.getFrom |
احصل على البريد الإلكتروني لمرسل Gmail |
https://developers.google.com/apps-script/reference/gmail/gmail-message#getFrom() |
GmailMessage.getTo |
احصل على مستقبل gamil |
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() |
الخصائصService.getUserProperties |
الوصول إلى تفضيلات أو إعداد المستخدم الدائم | |
الخصائص.getProperty |
احصل على خاصية محددة باستخدام المفتاح |
https://developers.google.com/apps-script/reference/properties/properties#getProperty(String) |
الخصائص.setProperty |
تعيين خاصية جديدة للمفتاح والقيمة |
https://developers.google.com/apps-script/reference/properties/properties#setProperty(String,String) |
الجلسة.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 |
استخدم واجهة API هذه للاتصال بخدمة Webex Addin أو واجهة API google لإنشاء/تحديث اجتماع، لن نتصل بأي خدمة طرف ثالث آخر |
https://developers.google.com/apps-script/reference/url-fetch/url-fetch-app#fetch(String) |
جوجل بقية API |
ما يفعله |
عنوان URL المرجعي |
---|---|---|
نشر https://accounts.google.com/o/oauth2/token |
الحصول على الرمز المميز لمصادقة Google |
https://developers.google.com/identity/protocols/oauth2/web-server#exchange-authorization-code |
احصل عليه 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 وحذفها بعد انتهاء اجتماع مجدول.
- كيف يمكننا تأمين بيانات العملاء التي "نسحبها" من هذا التكامل؟
-
نحن نجمع فقط البيانات التي نحتاجها ، ونخزنها فقط طالما أننا بحاجة إلى ذلك.
نقوم بجمع معلومات اجتماع Webex وتخزينها في سحابة Webex. نقوم بحذف معلومات الاجتماع بعد فترة زمنية معينة، والتي تتحكم فيها باستخدام سياسة الاحتفاظ بالبيانات في Webex الخاصة بك.
- هل نستخدم واجهة برمجة تطبيقات عامة أو خاصة للاتصال بخدمة Google؟
-
يعمل Addon على منصة Google السحابية والوصول إلى مكتبات Google المضمنة مباشرة.