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

لقطة شاشة للأذونات التي يطلبها 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()

التقويم.الحصول على المنطقة الزمنية 

احصل على المنطقة الزمنية  للتقويم

https://developers.google.com/apps-script/reference/calendar/calendar#getTimeZone()

التقويم.الأحداث.القائمة 

ابحث عن أحداث محددة تتطابق مع بعض المعايير

https://developers.google.com/calendar/api/v3/reference/events/list

التقويم.الأحداث.التصحيح 

تحديث بيانات التعريف الخاصة بالحدث 1} لتخزين معلومات اجتماع webex 

https://developers.google.com/calendar/api/v3/reference/events/patch

تقويم الحدث.الحضور 

الخصائص للوصول إلى الحضور في التقويم 

https://developers.google.com/calendar/api/v3/reference/events#resource

حدث التقويم.بيانات المؤتمر 

الخصائص للوصول إلى بيانات مؤتمر الحدث 

https://developers.google.com/calendar/api/v3/reference/events#resource

حدث التقويم.getTitle 

احصل على موضوع حدث التقويم. 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getTitle()

تقويم الحدث.getCreators 

احصل على منشئ حدث التقويم 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getCreators()

حدث التقويم.getStartTime 

احصل على وقت بدء الحدث 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getStartTime()

حدث التقويم.getEndTime 

احصل على وقت انتهاء الحدث 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getEndTime()

خدمة التخزين المؤقت.احصل على ذاكرة التخزين المؤقت للمستخدم 

احصل على ذاكرة التخزين المؤقت للمستخدم لاسترداد إعدادات  تفضيلات المستخدم 

https://developers.google.com/apps-script/reference/cache/cache-service#getUserCache()

ذاكرة التخزين المؤقت.احصل على 

الحصول على إعداد ذاكرة التخزين المؤقت المحدد  حسب المفتاح 

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 

https://developers.google.com/apps-script/reference/conference-data/conference-data-service#newConferenceDataBuilder()

منشئ بيانات المؤتمر.build 

إنشاء بيانات معلومات اجتماع webex 

https://developers.google.com/apps-script/reference/conference-data/conference-data-builder#build()

تطبيق Gmail.احصل على الرسالة حسب معرف 

استرداد رسالة gmail المحددة

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

تطبيق Gmail.إنشاء مسودة 

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

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

رسالة Gmail.احصل عليها من 

الحصول على بريد إلكتروني لمرسل Gmail 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getFrom()

رسالة Gmail.احصل على 

احصل على gamil receiver 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getTo()

رسالة Gmail.احصل على الموضوع 

الحصول على عنوان رسالة Gmail 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getSubject()

رسالة Gmail.getDate 

الحصول على تاريخ ووقت رسالة Gmail 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getDate()

خصائص الخدمة.getUserProperties 

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

https://developers.google.com/apps-script/reference/properties/properties-service#getUserProperties()

خصائص.احصل على الخاصية 

الحصول على خاصية محددة بالمفتاح 

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)

جلب تطبيق URL.جلب 

استخدم واجهة برمجة التطبيقات هذه للاتصال بخدمة Webex الإضافية أو واجهة برمجة تطبيقات 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 .