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