يمكنك تحسين تجربة المستخدمين الإجمالية من خلال اتّباع هذه الأدلة المتعلّقة بتصميم تطبيقات Google Meet الإضافية.
أفضل الممارسات المتعلّقة بالحصول على الأذونات
ننصحك باستخدام أفضل الممارسات التالية لأيّ إضافات Google Meet تتطلّب المصادقة أو التفويض.
استخدام ميزة "تسجيل الدخول باستخدام حساب Google"
سيكون العديد من مستخدمي إضافات Google Workspace قد سجّلوا الدخول إلى Google قبل الانضمام إلى الاجتماع. لذلك، يمكن أن يؤدي إتاحة Google One Tap كخيار إلى توفير عدة نقرات للمستخدمين عند تنفيذ عملية تسجيل الدخول. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة طرق تسجيل الدخول إلى الإضافة.
فتح صفحة تسجيل الدخول التابعة لجهة خارجية في نافذة جديدة
بالإضافة إلى ميزة "تسجيل الدخول باستخدام حساب Google"، قد يقدّم تطبيقك مزيدًا من آليات تسجيل الدخول. إذا كان الأمر كذلك، استخدِم نافذة حوار بدلاً من فتح صفحة تسجيل الدخول في علامة تبويب جديدة. بهذه الطريقة، سيظل بإمكان المستخدم الاطّلاع على مكالمة Meet والعودة إليها، وسيحتاج إلى عدد أقل من النقرات بشكل عام.
طلب النطاقات بشكل صحيح لواجهات برمجة تطبيقات Google
إذا كانت إضافة Meet تستدعي واجهات برمجة تطبيقات Google، يجب تقديم قائمة كاملة بنطاقات OAuth المطلوبة من خلال الإضافة. يتم ذلك في صفحة "ضبط تطبيق Google Workspace Marketplace". بعد إضافة هذين النطاقَين، تظهر للمستخدمين عند تثبيتهم لإضافة Meet مطالبة تُعلمهم بنوع البيانات التي يسمحون لتطبيقك بالوصول إليها.
قبل نشر الإضافة، يجب أيضًا إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth. يتطلّب ذلك إضافة نطاقات التفويض نفسها بالضبط من إعدادات تطبيقك على Google Workspace Marketplace. يتطلّب ضبط شاشة موافقة بروتوكول OAuth أيضًا ضبط معلومات العلامة التجارية وسياسة الخصوصية وأحكام الخدمة التي يتم عرضها عند طلب النطاقات. لنشر هذه المعلومات علنًا، يجب إرسالها لأجل إثبات صحتها.
عند كتابة رمز لاستدعاء واجهات برمجة تطبيقات Google Workspace، اتّباع الخطوات السهلة لبدء استخدام JavaScript هو أسهل طريقة للبدء. يتوافق هذا النهج مع أفضل الممارسات المتعلقة باستخدام ميزة "تسجيل الدخول باستخدام حساب Google" ونوافذ الحوار. يُرجى العِلم أنّ تهيئة رمز الاعتماد عميل في JavaScript تتطلّب طلب النطاقات التي يستخدمها التطبيق فعليًا في وقت التشغيل بشكل منفصل. لتقديم أفضل تجربة للمستخدم، يجب أن تتطابق النطاقات المطلوبة مع النطاقات الواردة في صفحة "إعدادات التطبيق" في Google Workspace Marketplace. يقدّم هذا التكرار بديلاً للتعامل مع الحالة التي يُبطل فيها المستخدم النطاقات.
أفضل الممارسات المتعلقة بالصيانة
إنّ أفضل الممارسات التالية مخصّصة لكتابة تطبيقات ويب قابلة للصيانة، ولكنّها مهمة بشكلٍ خاص عند كتابة أي ملحقات Meet.
استخدام أحدث إصدار من حزمة تطوير البرامج (SDK) لإضافات Google Meet
يتم تحديث حزمة تطوير البرامج (SDK) لإضافات Meet بانتظام. تلتزم حزمة SDK بالتصنيف الدلالي للإصدارات. للعثور على أحدث إصدار، اتّبِع الخطوات التالية:
- عند استخدام gstatic: يتضمّن عنوان URL لـ gstatic أحدث إصدار من حزمة SDK، ويمكن العثور عليه في تعليمات استخدام حزمة SDK.
- عند استخدام npm: يمكنك تشغيل
npm update @googleworkspace/meet-add-onsمن داخل الدليل الذي يحتوي علىpackage.jsonللموقع الإلكتروني الذي يستضيف إضافة Meet.
إنشاء مشروع على Google Cloud للنشر التجريبي
بعد نشر إضافة Google Meet على Google Workspace Marketplace، تصبح أي عمليات نشر جديدة لإضافة Google Meet متاحة على الفور لمستخدمي Meet. ستظهر هذه التعديلات للمستخدمين فور إفراغ ذاكرات التخزين المؤقت أو انتهاء صلاحيتها. لذلك، ننصحك بعدم نشر التغييرات على موقعك الإلكتروني العلني إلى أن يتم اختبارها بدقة.
لتجنُّب نشر التطبيق مباشرةً في قناة الإصدار العلني، ننصحك بإنشاء مشروع منفصل على Google Cloud يتم نشره بشكل خاص في مؤسستك. سيستضيف مشروع Cloud هذا كلّ من بيئة النشر و بيئة التطوير لإضافتك إلى Meet. يجب أن يقتصر الوصول إلى هذا المشروع على السحابة الإلكترونية على فريق صغير يعمل بشكل مباشر على تطوير الإضافة.
لإنشاء هذه البيئات البديلة للإضافات، عليك أولاً استضافة بيئات بديلة لتطبيق الويب الذي يحتوي على إضافتك على نطاق تملكه. بعد ذلك، يمكنك إنشاء بيئات بديلة لإضافة Meet من خلال إضافة عمليات نشر إضافية إلى مشروعك التجريبي على Google Cloud. يجب أن تتضمّن عمليات النشر الجديدة هذه ملفات بيان تشير إلى البيئات البديلة لتطبيق الويب. بعد ذلك، ننصحك بتثبيت كل بيئة إضافة على النحو التالي:
- الإصدار العلني: انشر الإصدار العلني بشكل خاص لكي يتمكّن أي مستخدم في مؤسستك من المساعدة في الاختبار.
- التطوير: انقر على تثبيت ضمن عمود الإجراءات لتثبيت إصدار تطوير إضافة Meet على حسابك فقط.
كتابة الاختبارات
قبل نشر إضافة Meet في بيئة تطوير، ننصحك بكتابة اختبارات وحدات. يجب أن تتضمّن اختبارات الوحدة ما يلي:
- محاكاة حزمة تطوير البرامج (SDK) لإضافات Meet، ثم التأكّد من أنّ إضافة Meet تستدعي وظائف حزمة SDK على النحو المتوقّع
- اختبار الوحدة لجميع وظائف الإضافة التي لا تتعلّق بحزمة تطوير البرامج (SDK) باستخدام إطار عمل اختبار الويب المفضّل لديك
أفضل الممارسات المتعلّقة بتجربة المستخدم
تساعد أفضل الممارسات التالية في جعل الوظيفة الإضافية في Meet أكثر سهولة ودقة.
إدارة جميع حالات البدء في اللوحة الجانبية
ننصحك بشدة بإعداد الإضافة استنادًا إلى
إجراءات المستخدم التي تم اتّخاذها في اللوحة الجانبية.
ويتم ذلك من خلال ضبط حالة بدء النشاط في
JavaScript. يجب أن يضبط مُنشئ الإضافة (عادةً هو
مضيف الاجتماع) جميع البيانات التي يتم إدخالها في
ActivityStartingState
ضمن اللوحة الجانبية. يمكنك اعتبار العرض الأول للملف الشخصي في
اللوحة الجانبية كنموذج يتحكّم في إعدادات
الإضافة.
إغلاق اللوحة الجانبية عند عدم استخدامها
بعد بدء النشاط من خلال استدعاء startActivity()
الطريقة، يجب إبقاء الجانب
لوحة مفتوحة فقط إذا كانت جزءًا أساسيًا
من تجربة المستخدم لإضافة Google Meet. يمكنك إغلاق
اللوحة الجانبية بعد فتح المرحلة الرئيسية
من خلال استدعاء الأسلوب
unloadSidePanel().
الترويج لإضافتك في Meet من خلال مشاركة الشاشة
تقدّم إضافات Meet تجربة أكثر تفاعلية من مشاركة الشاشة. ومع ذلك، اعتاد العديد من المستخدمين على استخدام ميزة مشاركة الشاشة في Meet. إذا شارك مستخدم علامة تبويب تعرض الموقع الإلكتروني الذي يستضيف إضافة Meet، يمكن ضبط Meet لعرض بانر لجميع المشاركين في المكالمة يطلب منهم تثبيت إضافة Meet المقابلة أو استخدامها. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الترويج لإضافتك من خلال مشاركة الشاشة.
إرشادات تصميم الشعارات
اتّبِع هذه الإرشادات عند تصميم شعار Meet الخاص بك ل إظهاره بأفضل شكل الآن وفي المستقبل:
استخدِم تنسيق ملف PNG بحجم 256 بكسل × 256 بكسل.
استخدِم الشفافية.
تأكَّد من أنّ شعارك المخصّص للوضع الداكن يبدو جيدًا في هذا الوضع باستخدام أدوات المطوّرين لإضافات Meet.
يجب الالتزام بمتطلبات الرسومات لدمج تطبيقات معيّنة.
لا تترك مساحة حول صورتك. يمكنك توسيع الصورة إلى حدود ملفك بدلاً من ذلك.