الأذونات المطلوبة بواسطة إضافة Webex لـ Google Workspace

list-menuهل لديك ملاحظات؟
عندما تسمح لـ Webex بالوصول إلى حساب Google الخاص بك، تطلب الإضافة أذونات للوصول إلى بيانات المستخدم. يسرد هذا الموضوع الأذونات التي نطلبها وسبب حاجتنا إليها وكيفية تعاملنا مع بياناتك.

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

Screenshot of the permissions that Webex requests when you enable the scheduler to connect to your Google account
يطلب Webex هذه الأذونات
الجدول 1. الأذونات المطلوبة وكيفية استخدام Webex لها

الإذن

النطاق

تم الوصول إلى البيانات

ما الغرض من استخدام Webex؟

عرض البيانات الوصفية لرسائل البريد الإلكتروني الخاصة بك عند تشغيل الوظيفة الإضافية

Gmail

سطر الموضوع والتاريخ والوقت وقائمة المدعوين

عندما تقوم بجدولة اجتماع Webex في Gmail، يقرأ المجدول هذه الأجزاء من المعلومات، والتي تعد المتطلبات الأساسية لجدولة الاجتماع.

تشغيل كإضافة Gmail

Gmail

—

يسمح لبرنامج Webex Scheduler بالعمل في Gmail الخاص بالمستخدم.

شاهد الأحداث التي تفتحها في تقويم Google

تقويم

سطر الموضوع والتاريخ والوقت وقائمة المدعوين

عندما تفتح حدثًا في تقويم Google، يقرأ المجدول هذه الأجزاء من المعلومات، والتي تعد المتطلبات الأساسية لجدولة الاجتماع.

تحرير الأحداث التي تفتحها في تقويم Google

تقويم

سطر الموضوع

أضف معلومات بيانات مؤتمر Webex (واجهة مستخدم البطاقة/الملكية) إلى حدث التقويم المفتوح الحالي.

قم بالتشغيل كإضافة للتقويم

تقويم

—

يسمح بتشغيل Webex Scheduler في تقويم Google الخاص بالمستخدم

عرض الأحداث وتحريرها في جميع التقويمات الخاصة بك

تقويم

اقرأ سطر الموضوع والتاريخ والوقت وقائمة المدعوين

تحرير سطر الموضوع

يتيح لنا دعم سيناريوهات التقويم المشتركة، بنفس الطريقة التي نقرأ بها من الأحداث ونكتب إليها في تقويم مستخدم واحد.

عرض إعدادات التقويم

تقويم

—

يتطلب Google OAuth 2.0 هذا النطاق. راجع https://developers.google.com/calendar/api/guides/auth.

اطّلع على معلومات حول المستخدمين على نطاقك

مشرف غوغل وورك سبيس

عنوان URL لموقع Webex في معلومات مستخدم Google

إذا قمت بتعيين Webex SiteURL في معلومات مستخدم Google، فيمكننا قراءة عنوان URL هذا وتسجيل الدخول إلى هذا الموقع باعتباره الإعداد الافتراضي للمستخدم.

الاتصال بخدمة خارجية

سكربت التطبيقات

الاتصال بخدمة Webex

يحتاج المجدول إلى الاتصال بخدمة Webex لطلب إنشاء/تحديث/حذف اجتماع Webex المرتبط.

السماح بتشغيل هذا التطبيق عندما لا تكون موجودًا

سكربت التطبيقات

الوصول إلى كائن حدث Google استنادًا إلى مشغل Google

يتيح ذلك تشغيل المجدول عندما لا تكون موجودًا، استجابةً لمشغل Google، على سبيل المثال لتحديث/حذف اجتماع في التقويم الخاص بك. راجع https://developers.google.com/apps-script/guides/triggers/events.

عرض البيانات المرتبطة بالتطبيق وإدارتها

سكربت التطبيقات

ذاكرة التخزين المؤقت للتطبيق

يخزن المجدول بعض معلومات Webex في مساحة تخزين Google. على سبيل المثال، عنوان URL لموقع Webex ونموذج اجتماع Webex.

عرض بلدك ولغتك ومنطقتك الزمنية

سكربت التطبيقات

الوقت الحالي للمستخدم

يقوم المجدول بقراءة المنطقة الزمنية الخاصة بك لجدولة اجتماع Webex المرتبط أو تحديثه.

راجع عنوان البريد الإلكتروني الأساسي لحساب Google

أخرى

عنوان حساب Gmail الخاص بالمستخدم

يقوم المجدول بقراءة عنوان البريد الإلكتروني للمستخدم لربطه بحساب Webex الخاص به.

اطلع على معلوماتك الشخصية، بما في ذلك أي معلومات شخصية جعلتها متاحة للجمهور

أخرى

اسم المستخدم واللغة المفضلة (الافتراضي)

يقوم المجدول بقراءة معلومات المستخدم العامة للمستخدم، بما في ذلك الاسم الكامل واللغة المفضلة لاستخدامها كإعداد افتراضي للمستخدم.

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

Architecture diagram showing the Google cloud, Webex cloud, and the Google Calendar client, with numbered arrows linking them.
  1. يستخدم مسؤول الموقع إدارة الموقع أو مركز التحكم لتمكين إضافة Webex لـ Google Workspace.

  2. يصرح كل فرد بالأذونات لإضافة Webex لـ Google Workspace (إذا لم يأذن المشرف) ويربط حساب Google الخاص به بحساب Webex الخاص به.

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

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

  5. يتلقى عميل Webex الإضافي إشعارات تقويم Google ويتزامن مع Webex.

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

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

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

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

واجهة برمجة تطبيقات Google البرمجية

ماذا يفعل

عنوان URL المرجعي

التقويم. احصل على معرف 

احصل على معرف تقويم المستخدم، معرف التقويم الافتراضي هو عنوان البريد الإلكتروني للمستخدم 

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

التقويم. احصل على الاسم 

احصل على اسم التقويم 

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

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

قم بتحديث البيانات الوصفية للحدث المحدد لتخزين معلومات اجتماع 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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)

خدمة بيانات المؤتمرات، أداة إنشاء بيانات المؤتمرات الجديدة 

قم بإنشاء بنية بيانات خاصة بـ 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. انتقل إلى 

احصل على جهاز استقبال Gmail 

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. احصل على التاريخ 

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

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

خدمة الخصائص. احصل على خصائص المستخدم 

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

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

الخصائص. احصل على عقار 

احصل على عقار محدد عن طريق المفتاح 

https://developers.google.com/apps-script/reference/properties/properties#getProperty(String)

الخصائص. تعيين الخاصية 

تعيين خاصية جديدة للمفتاح والقيمة 

https://developers.google.com/apps-script/reference/properties/properties#setProperty(String,String)

Session.احصل على مستخدم فعال (). احصل على بريد إلكتروني 

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

https://developers.google.com/apps-script/reference/base/user#getEmail ()

تطبيق البرنامج النصي. مشغل جديد 

قم بإعداد مشغل جديد للتعامل مع تحديث الأحداث 

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

عنوان urlfetchapp.fetch 

استخدم واجهة برمجة التطبيقات هذه للاتصال بخدمة Webex Addin أو google API لإنشاء/تحديث الاجتماع، ولن نتصل بأي خدمة أخرى تابعة لجهة خارجية 

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

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

واجهة برمجة تطبيقات غوغل ريست

ماذا يفعل

عنوان 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.

هل كان هذا المقال مفيدًا؟
هل كان هذا المقال مفيدًا؟