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