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

لقطة شاشة للأذونات التي يطلبها Webex عند تمكين المجدول من الاتصال بحسابك على Google
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، مع وجود أسهم مرقمة تربطها.
  1. يستخدم مشرف موقعك إدارة الموقع أو مركز التحكم لتمكين الوظيفة الإضافية Webex ل Google Workspace.

  2. يأذن كل فرد بالأذونات للوظيفة الإضافية Webex ل G Suite (إذا لم يفوض مشرفك) ويربط حسابه على Google بحسابه على Webex.

  3. يشترك Webex في تغييرات التقويم من Google.

  4. يضيف المستخدم اجتماع Webex إلى حدث في تقويم Google، أو يحدث الوقت أو الموضوع، أو ينسخ حدثا إلى تاريخ ووقت آخرين.

  5. يتلقى عميل 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 المرجعي

التقويم.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   وعرضها

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.createمسودة 

إنشاء رسالة Gmail تحتوي على نص البريد الإلكتروني الخاص بـ  webex  

https://developers.google.com/apps-script/reference/gmail/gmail-app#createDraft(String,String,String)

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 

الوصول إلى  تفضيلات أو إعداد المستخدم الدائم 

https://developers.google.com/apps-script/reference/properties/properties-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)

الجدول رقم 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

احصل عليه ⁦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 .