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