تتطلب الإضافات إذنًا من المستخدم قبل أن تتمكن من العمل. وينطبق ذلك على كل من الإضافات المنشورة التي ثبَّتها من Google Workspace Marketplace والإضافات التي تطوِّرها بنفسك.
تفويض الإضافات المنشورة
بعد تثبيت إضافة منشورة، يبدأ تدفق التفويض على الفور:
- سيُطلب منك اختيار حساب لتثبيت الإضافة.
- بعد ذلك تظهر لك قائمة بالأذونات التي تتطلبها الإضافة لكي تتمكّن من معرفة الإجراء الذي تحاول تنفيذه. يُرجى مراجعة هذه القائمة بعناية، وإذا كنت لا تزال تريد منح الإضافة إذن، فانقر على سماح. يؤدي ذلك إلى تفعيل استخدام الإضافة.
- يمكنك الآن تشغيلها من التطبيق المضيف الذي يقوم بتوسيعه. إذا كان التطبيق مفتوحًا في علامة تبويب متصفّح، قد تحتاج إلى إعادة تحميل علامة التبويب قبل أن تصبح الإضافة متاحة.
إذا تم تحديث الإضافة التي ثبَّتها لاحقًا وتتطلب تفويضات إضافية لم تمنحها بعد، سيُطلب منك تقديم هذه الأذونات في المرة التالية التي تستخدم فيها الإضافة.
تفويض إضافات Google Workspace غير المنشورة
لا تتضمَّن الإضافات غير المنشورة مسار التفويض نفسه المُستخدَم للإضافات المنشورة لأنها غير مُدرَجة في Google Workspace Marketplace حتى الآن. بعد تثبيت إضافة غير منشورة، لن يُطلب منك على الفور منح الإذن. بدلاً من ذلك، يبدأ تدفق التفويض عند محاولة استخدام الإضافة لأول مرة.
عند تشغيل إضافة، يتم تحديد ما إذا كانت هناك حاجة إلى تفويض المستخدم أم لا. إذا كان التفويض ضروريًا، تقدِّم الإضافة بطاقة التفويض. ويكون التفويض مطلوبًا دائمًا في المرة الأولى التي يتم فيها تنفيذ إضافة، وقد يكون مطلوبًا أيضًا إذا كان إصدار جديد من الإضافة يستخدم خدمة لم يتم التصريح بها سابقًا. يوفر الزر تفويض الوصول نافذة حوار للمستخدم للسماح بتفويض الإضافة أو رفضها.
تفويض الخدمات غير التابعة لشركة Google لإضافة Google Workspace
من الممكن ربط "إضافة Google Workspace" بخدمة تابعة لجهة خارجية تتطلّب في حد ذاتها إذنًا. تتطلّب إضافات Google Workspace التي تتصل بهذه الخدمات إجراءَين منفصلَين من المستخدم:
- تفويض الإضافة نفسها عند تثبيت الإضافة أو بدؤها لأول مرة.
- الترخيص للخدمة غير التابعة لـ Google عند الوصول إليها لأول مرة.
إذا كانت إحدى إضافات Google Workspace التي تطوّرها تحتاج إلى الوصول إلى خدمة غير تابعة لشركة Google باستخدام OAuth، عليك ضبط الاتصال لهذه الخدمة عند إنشاء الإضافة.
عند طلب تفويض خدمة غير تابعة لـ Google، تقدّم إضافة Google Workspace للمستخدم بطاقة مطالبة بتفويض لهذه الخدمة. يمكنك تخصيص مطالبة التفويض هذه إذا أردت، أو استخدام البطاقة التلقائية.
لمزيد من التفاصيل، يُرجى الرجوع إلى دليل الربط بخدمات غير تابعة لشركة Google.
أنظمة مكالمات الفيديو التابعة لجهات خارجية
يمكن أيضًا لإضافات Google Workspace التي توفِّر "تقويم Google" إضافة المزيد من حلول مكالمات الفيديو التي تتيح للمستخدمين اختيار نظام مكالمات فيديو تابع لجهة خارجية عند تعديل أحداث "تقويم Google". إذا كانت إضافتك توفّر خيارات مكالمات فيديو تتطلب من المستخدم تسجيل الدخول إليها، يجب أن تتيح إضافتك للمستخدم إمكانية تسجيل الدخول إليها.
إذا حاول المستخدم إنشاء مكالمة فيديو باستخدام إضافتك بدون تسجيل الدخول
الضروري، من المفترض أن تعرض طريقة onCreateFunction
لحلول مكالمات الفيديو عنصر
ConferenceData
يحتوي على
ConferenceError
مع
عنوان URL للمصادقة.
عند استلام هذا العنصر، ينشئ "تقويم Google" زر تسجيل الدخول في واجهة مستخدم تعديل الحدث والذي يرتبط بعنوان URL للمصادقة الذي توفّره الإضافة. بعد ذلك، يمكن للمستخدمين استخدام هذا الزر لتسجيل الدخول إلى نظام الجهة الخارجية قبل استخدام الإضافة بشكل أكبر.
يُرجى الاطِّلاع على إنشاء مكالمات فيديو تابعة لجهات خارجية
لمزيد من التفاصيل حول التعامل مع التفويض باستخدام ConferenceError.
تفويض إضافات المحرِّر غير المنشورة
ومن أفضل الممارسات اختبار إضافات المحرِّر أثناء تطويرها. يكون مسار التفويض متطابقًا مع مسار إضافات المحرّر المنشورة، باستثناء أن المسار يبدأ عند محاولة اختبار الإضافة لأول مرة. إذا أعدت اختبار الوظيفة الإضافية نفسها لاحقًا، فلن تتم مطالبتك بالتفويض مرة أخرى.
إلغاء مصادقة الإضافات
عند تطوير الإضافات، قد يكون من المفيد إلغاء تفويضها حتى تتمكن من إعادة اختبار تدفق التفويض.
يمكنك إلغاء تفويض إحدى الإضافات من خلال تنفيذ ما يلي:
- افتح وحدة تحكُّم أمان الحساب.
- حدِّد موقع الإضافة التي تريد إلغاء تفويضها وانقر عليها.
- انقر على إزالة إذن الوصول.
عند تشغيل الإضافة مجددًا بعد إلغاء التفويض، يتم عرض مسار عملية التفويض مرة أخرى.