عندما تقوم بتفويض Webex بالوصول إلى حساب Google الخاص بك، تطلب الوظيفة الإضافية أذونات للوصول إلى بيانات المستخدم. يسرد هذا الموضوع الأذونات التي نطلبها، ولماذا نحتاج إليها، وكيف نتعامل مع بياناتك.
أذونات حساب المستخدم
الإذن | النطاق | البيانات التي تم الوصول إليها | ما الذي يستخدمه Webex؟ |
|---|---|---|---|
عرض بيانات تعريف رسالة البريد الإلكتروني الخاصة بك عند تشغيل الأداة الإضافية | البريد الإلكتروني | سطر الموضوع، التاريخ والوقت، قائمة المدعوين | عند جدولة اجتماع Webex في Gmail، يقرأ المجدول هذه المعلومات، والتي تمثل المتطلبات الأساسية لجدولة الاجتماع. |
تشغيل كمساعد Gmail | البريد الإلكتروني | — | السماح لمجدول Webex بتشغيل Gmail الخاص بالمستخدم. |
اطلع على الأحداث التي تفتحها في Google Calendar | التقويم | سطر الموضوع، التاريخ والوقت، قائمة المدعوين | عند فتح حدث في Google Calendar، يقرأ المجدول هذه المعلومات، وهي المتطلبات الأساسية لجدولة الاجتماع. |
تحرير الأحداث التي تقوم بفتحها في Google Calendar | التقويم | سطر الموضوع | أضف معلومات بيانات مؤتمر Webex (واجهة مستخدم البطاقة/خاصية) إلى حدث التقويم المفتوح الحالي. |
تشغيل أداة إضافية للتقويم | التقويم | — | السماح لمجدول Webex بتشغيل تقويم Google الخاص بالمستخدم |
عرض الأحداث وتحريرها على جميع التقويمات الخاصة بك | التقويم | قراءة سطر الموضوع والتاريخ والوقت، قائمة المدعوين تحرير سطر الموضوع | يسمح لنا بدعم سيناريوهات التقويم المشترك، بنفس الطريقة التي نقرأ بها من الأحداث ونكتب إليها في تقويم مستخدم واحد. |
عرض إعدادات التقويم الخاصة بك | التقويم | — | يتطلب Google OAuth 2.0 هذا النطاق. انظرhttps://developers.google.com/calendar/api/guides/auth . |
اطلع على معلومات حول المستخدمين على مجالك | مسؤول مساحة عمل Google | عنوان موقع WebexURL في معلومات مستخدم Google | إذا قمت بتعيين عنوان Webex siteURL في معلومات مستخدم Google، فيمكننا قراءة عنوان URL هذا وتسجيل الدخول إلى هذا الموقع كخيار افتراضي للمستخدم. |
الاتصال بخدمة خارجية | البرنامج النصي للتطبيقات | الاتصال بخدمة Webex | يحتاج المجدول إلى الاتصال بخدمة Webex لطلب إنشاء/تحديث/حذف اجتماع Webex المرتبط. |
اسمح لهذا التطبيق بتشغيله عندما لا تكون حاضرًا | البرنامج النصي للتطبيقات | الوصول إلى كائن حدث Google بناءً على Google trigger | يسمح هذا للمجدول بتشغيل عندما لا تكون موجودًا، استجابةً لمشغل Google، على سبيل المثال لتحديث/حذف اجتماع في التقويم الخاص بك. انظرhttps://developers.google.com/apps-script/guides/triggers/events . |
عرض البيانات المرتبطة بالتطبيق وإدارتها | البرنامج النصي للتطبيقات | ذاكرة التخزين المؤقت للتطبيق | يقوم Scheduler بتخزين بعض معلومات Webex في تخزين Google. على سبيل المثال، عنوان URL لموقع Webex وقالب اجتماع Webex. |
عرض بلدك ولغتك ومنطقتك الزمنية | البرنامج النصي للتطبيقات | الوقت الحالي للمستخدم | يقرأ المجدول منطقتك الزمنية لجدولة اجتماع Webex المرتبط أو تحديثه |
راجع عنوان البريد الإلكتروني الأساسي لحساب Google الخاص بك | أخرى | عنوان حساب Gmail الخاص بالمستخدم | يقرأ المجدول عنوان البريد الإلكتروني للمستخدم لربطه بحساب Webex الخاص به. |
راجع معلوماتك الشخصية، بما في ذلك أي معلومات شخصية قمت بإتاحتها للجمهور | أخرى | اسم المستخدم واللغة المفضلة (افتراضي) | يقرأ المجدول معلومات المستخدم العامة، بما في ذلك الاسم الكامل، واللغة المفضلة لاستخدامها كخيار افتراضي للمستخدم. |
نظرة عامة على بنية مجدول Webex
يستخدم مسؤول موقعك إدارة الموقع أو Control Hub لتمكين الوظيفة الإضافية Webex لمساحة عمل Google.
يقوم كل فرد بتفويض أذونات أداة Webex الإضافية لمساحة عمل Google (إذا لم يأذن المسؤول لديك) ويقوم بتوصيل حساب Google الخاص به بحساب Webex الخاص به.
يشترك Webex في تغييرات التقويم من Google.
يضيف المستخدم اجتماع Webex إلى حدث Google Calendar، أو يقوم بتحديث الوقت أو الموضوع، أو ينسخ الحدث إلى تاريخ ووقت آخر.
يتلقى عميل Webex الإضافي إشعارات Google Calendar ويزامن مع Webex.
واجهات API Google المستخدمة من قبل مجدول Webex
توفر الجداول أدناه معلومات عن واجهات برمجة تطبيقات Google التي يستخدمها مجدول Webex.
 | في معظم الحالات، يستخدم Webex Scheduler واجهة برمجة تطبيقات Google App Script. في حالات قليلة، يستخدم المجدول واجهة برمجة تطبيقات Google REST. بشكل عام ، يلف API Script App Google REST API المرتبط به. يشير عمود عنوان URL المرجعي إلى واجهة برمجة تطبيقات Google حيثما أمكن، ولكن قد يشير إلى عنوان URL المرجعي لواجهة برمجة تطبيقات Google REST API إذا لزم الأمر. |
واجهة برمجة تطبيقات Google App Script | ماذا تفعل | عنوان 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. | خصائص الوصول إلى الحضور في التقويم | 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() |
ذاكرة التخزين المؤقت.get | احصل على إعداد ذاكرة التخزين المؤقت حسب المفتاح | https://developers.google.com/apps-script/reference/cache/cache#get(String) |
ذاكرة التخزين المؤقت.ضع | تعيين بعض ذاكرة التخزين المؤقت حسب المفتاح | 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.createDraft | إنشاء رسالة 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() |
PropertiesService.getUserProperties | الوصول إلى بيروستمنت المستخدم أو الإعداد المستمرّ | |
Properties.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) |
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 Service أو واجهة برمجة تطبيقات google لإنشاء/تحديث الاجتماع، ولن نتصل بأي خدمة أخرى من خدمات الطرف الثالث | https://developers.google.com/apps-script/reference/url-fetch/url-fetch-app#fetch(String) |
واجهة برمجة تطبيقات Google REST | ماذا تفعل | عنوان 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 مباشرةً.
