يجب على المستخدمين تثبيت إضافة واعتمادها قبل أن يتمكنوا من فتحها واستخدامها. نظرًا لأن هذه الخطوات هي الجزء الأول من تجربة مستخدم الإضافة، يجب أن تفهمها قبل أن تبدأ في إنشاء الإضافات الخاصة بك.
يصف قسم الوثائق هذا كيف يمكن للمستخدمين تثبيت الإضافات وتفويضها وبدء استخدامها.
تثبيت الإضافات
قبل أن تتمكّن من استخدام إضافة ما، عليك تثبيتها. بعد تثبيت الإضافة، تصبح متوفّرة في تطبيق المضيف على Google Workspace والذي يتسع نطاقه.
يمكنك تثبيت الإضافات المنشورة من تطبيق مضيف Google Workspace أو من Google Workspace Marketplace. يمكن لمشرفي النطاقات أيضًا تثبيت الإضافات نيابةً عن المستخدمين لديهم من Google Workspace Marketplace. يمكنك أيضًا تثبيت الإضافات غير المنشورة التي تطوّرها لتتمكّن من اختبارها. قبل أن تتمكّن من استخدام إضافة مثبَّتة لأول مرة، يجب تفويضها.
لمزيد من التفاصيل، يُرجى الاطّلاع على نشر الإضافات.
السماح بالإضافات
بعد تثبيت إضافة، تصبح متاحة في تطبيق المضيف في Google Workspace. في المرة الأولى التي يحاول فيها أحد المستخدمين استخدام الإضافة من خلال تطبيق المضيف، يعرض له بطاقة تفويض أو مربّع حوار. توضح هذه البطاقة ما تحتاج الإضافة إلى إذن للقيام به للمستخدم، مثل الوصول إلى محتوى جدول بيانات Google الحالي. يمكن للمستخدم بعد ذلك منح هذه الأذونات والسماح للإضافة بالمتابعة. إذا رفض المستخدم تفويض الإضافة، لا يمكنه استخدام الإضافة.
تستخدم إضافات "محرّر إعلانات Google" نموذج تفويض يختلف عن "إضافات Google Workspace". ولأنّ إضافات "محرّر إعلانات Google" تعمل على ملفات Google Drive، يحدّد نموذج تفويض المحرّر أوضاع التفويض المختلفة التي تنتج عن استخدام الإضافات مع ملفات فردية. وعند تطوير "إضافات المحرّر"، يجب فهم الأوضاع المختلفة وكيفية انتقال تلك الإضافات بينها.
السماح للإضافات المنشورة
بعد تثبيت إضافة منشورة، يبدأ مسار التفويض على الفور:
- سيُطلب منك اختيار حساب لتثبيت الإضافة عليه.
- ستظهر لك بعد ذلك قائمة بالتفويضات التي تتطلبها الإضافة لكي تعرف ما تحاول فعله. راجع هذه القائمة بعناية، وإذا كنت لا تزال تريد منح الإذن، فانقر على سماح. يؤدي هذا الإجراء إلى تفعيل الإضافة.
- يمكنك تشغيله الآن من خلال تطبيق المضيف الذي يتضمّنه. إذا كان التطبيق مفتوحًا بالفعل في علامة تبويب المتصفح، فقد تحتاج إلى تحديث علامة التبويب قبل أن تصبح الإضافة متاحة.
إذا تم تحديث الإضافة التي ثبَّتها لاحقًا وكانت تتطلّب تفويضات إضافية لم تمنحها بعد، سيُطلَب منك تقديم هذه الأذونات في المرة التالية التي تستخدم فيها الإضافة.
السماح بإضافات 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" أثناء تطويرها. ويتطابق مسار التفويض مع مسار إضافات المحرِّر المنشورة، إلا أنّ التدفق يبدأ عند محاولة اختبار الإضافة لأول مرة. إذا أعدت اختبار نفس الوظيفة الإضافية لاحقًا، فلن يُطلب منك التفويض مرة أخرى.
إلغاء تفويض الإضافات
عند تطوير الإضافات، قد يكون من المفيد إلغاء تفويضها حتى تتمكن من إعادة اختبار تدفق التفويض.
يمكنك إلغاء تفويض إضافة من خلال تنفيذ ما يلي:
- افتح وحدة تحكّم أمان الحساب.
- حدِّد موقع الإضافة التي تريد إلغاء تفويضها وانقر عليها.
- انقر على إزالة إمكانية الوصول.
عند تشغيل الإضافة مرة أخرى بعد عدم تصريحها، يتم عرض تدفق التفويض مرة أخرى.