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