أفضل الممارسات

تحسين تجربة المستخدمين تجربتك العامة من خلال اتباع هذه الأدلة تصميم إضافة Google Meet

أفضل الممارسات المتعلقة بالتفويض

ننصحك باتّباع أفضل الممارسات التالية إضافات Google Meet التي تتطلّب مصادقة أو تفويضًا

استخدام تسجيل الدخول بحساب Google

كان العديد من مستخدمي إضافات Google Workspace قد سبق لهم تسجيل الدخول إلى Google. للانضمام إلى الاجتماع. لذلك، فإنّ استخدام تسجيل الدخول بحساب Google متاحة كخيار إلى توفير عدة نقرات للمستخدمين عند الانتقال إلى تدفق تسجيل الدخول.

فتح صفحة تسجيل الدخول في نافذة جديدة في نافذة جديدة

بالإضافة إلى تسجيل الدخول باستخدام حساب Google، قد يوفّر تطبيقك معلومات إضافية لتسجيل الدخول والآليات الأخرى. إذا كان الأمر كذلك، فاستخدم نافذة حوار بدلاً من فتح صفحة تسجيل الدخول في علامة تبويب جديدة. وبهذه الطريقة، يظل المستخدم قادرًا على مشاهدة Meet، وإجراء نقرات إجمالية أقل.

طلب نطاقات Google APIs بشكلٍ صحيح

إذا استدعت الإضافة Meet Google APIs، يجب تقديم قائمة كاملة ببروتوكولات OAuth النطاقات التي تتطلبها إضافتك. يتم ذلك في صفحة إعدادات تطبيق Google Workspace Marketplace. بعد إضافة هذه النطاقات، سيظهر للمستخدمين لديك طلب عند تثبيت إضافة Meet التي تخبر المستخدمين بنوع البيانات التي يستخدمونها السماح للتطبيق بالوصول إلى البيانات

قبل نشر الإضافة: عليك أيضًا إعداد موافقة OAuth. الشاشة. ويتطلب هذا إضافة نطاقات الأذونات نفسها تمامًا من إعدادات تطبيق Google Workspace Marketplace إعداد بروتوكول OAuth تتطلّب ميزة "شاشة طلب الموافقة" أيضًا ضبط معلومات العلامة التجارية وسياسة الخصوصية وبنود الخدمة التي يتم عرضها عند طلب النطاقات. للنشر بشكل علني، يجب تقديم كل هذه المعلومات إلى التحقق.

عند كتابة رمز لطلب واجهات برمجة التطبيقات في Google Workspace، يجب اتّباع لغة JavaScript. التشغيل السريع هي أسهل طريقة للبدء. يلتزم هذا النهج بأفضل ممارسات باستخدام تسجيل الدخول بحساب Google ونوافذ مربعات الحوار. لاحظ أن تهيئة الرمز المميز العميل في JavaScript يتطلب بشكل منفصل طلب النطاقات التي المستخدم في وقت التشغيل. للحصول على أفضل تجربة للمستخدم، فإن هذه النطاقات المطلوبة أن تتطابق مع تلك الواردة في إعدادات تطبيق Google Workspace Marketplace . يوفر هذا التكرار تدبيرًا احتياطيًا للتعامل مع الحالة التي ألغى مستخدم والنطاقات.

أفضل ممارسات الصيانة

أفضل الممارسات التالية لكتابة محتوى يمكن الحفاظ عليه وتطبيقات الويب، ولكنها ذات أهمية خاصة عند كتابة أي إضافات Meet

استخدام أحدث إصدار من حزمة تطوير البرامج للإضافات في Google Meet

يتم تحديث حزمة تطوير البرامج لإضافات Meet بانتظام. تلتزم SDK بـ الصياغة الدلالية. للعثور على أحدث إصدار:

  • عند استخدام gstatic: يتم تضمين أحدث إصدار من حزمة SDK في واجهة gstatic. عنوان URL المتوفّر في تعليمات استخدام حزمة تطوير البرامج (SDK).
  • عند استخدام npm: شغِّل npm update @googleworkspace/meet-add-ons من داخل الدليل الذي يحتوي على package.json للموقع الإلكتروني الذي يستضيف إضافة Meet.

إنشاء مشروع مرحلي على Google Cloud

بعد نشر إضافة Google Meet على Google Workspace Marketplace، إجراء أي عمليات نشر جديدة لإضافة Google Meet على الفور متاحة لمستخدمي Meet. ستظهر هذه التعديلات للمستخدمين بعد يقوم بإفراغ ذاكرات التخزين المؤقت الخاصة بهم أو تنتهي صلاحية ذاكرة التخزين المؤقت. لذلك، ننصحك بعدم دفع التغييرات إلى موقع الإنتاج حتى يتم اختبار التغييرات بدقة.

لتجنُّب نشر التطبيق في مرحلة الإنتاج مباشرةً، ننصحك بإنشاء حساب مشروع Google Cloud الذي يتم نشره بشكل خاص لمؤسستك. سيستضيف هذا المشروع على Google Cloud مراحل بيئات تطوير إضافة Meet. الوصول إلى البيانات لهذا المشروع على السحابة الإلكترونية، أن يقتصر على فريق أصغر الذين يعملون مباشرةً على تطوير إضافتك.

لإنشاء هذه البيئات البديلة لإضافتك، تحتاج أولاً إلى استضافة بيئات بديلة لتطبيق الويب لديك يحتوي على إضافتك على نطاق تملكه. بعد ذلك، يُرجى اتّباع الخطوات التالية: يمكنك إنشاء بيئات بديلة يمكنك استخدام إضافة Meet من خلال إدراج المزيد من عمليات النشر إلى مشروعك على Google Cloud منظّم. ينبغي أن تتضمن عمليات النشر الجديدة هذه التي تشير إلى البيئات البديلة لتطبيق الويب. بعد ذلك، ننصحك بتثبيت كل إضافة البيئة على النحو التالي:

  • التقسيم المرحلي: نشر الإصدار المرحلي بخصوصية تامّة بحيث يمكن لأي شخص في مؤسستك المساعدة في الاختبار.
  • التطوير: انقر على تثبيت ضمن عمود الإجراءات لتثبيت إتاحة إصدار التطوير من الإضافة في حسابك فقط

كتابة الاختبارات

قبل نشر إضافة Meet في تطوير ننصح بكتابة اختبارات الوحدة. يجب أن تتضمن اختبارات الوحدة ما يلي:

  • محاكاة "حزمة تطوير البرامج للإضافات في Meet"، ثم التحقّق من تستدعي إضافة Meet وظائف حزمة تطوير البرامج (SDK) على النحو المتوقّع.
  • تختبر الوحدة جميع الوظائف غير ذات الصلة بحزمة SDK في مع إطار عمل اختبار الويب الذي تفضله.

أفضل الممارسات بشأن تجربة المستخدم

تساعد أفضل الممارسات التالية في إنشاء إضافة Meet. أكثر سهولة وتنقيحًا.

إدارة جميع حالات البدء في اللوحة الجانبية

ننصحك بشدة بإعداد الإضافة استنادًا إلى إجراءات المستخدمين التي تم اتخاذها في اللوحة الجانبية. ويتم ذلك من خلال إعداد بدء التعاون الولاية في JavaScript. جميع البيانات التي تدخل في CollaborationStartingState يجب أن يتم تعيينه بواسطة بادئ تشغيل الإضافة (عادةً مضيف الاجتماع) في اللوحة الجانبية. يمكنك التفكير في العرض الأول اللوحة الجانبية كنموذج يتحكم في إعداد الإضافية.

إغلاق اللوحة الجانبية عندما لا تكون قيد الاستخدام

بعد بدء النشاط عن طريق الاتصال startCollaboration، يجب الاحتفاظ فقط باللوحة الجانبية. مفتوحًا إذا كانت جزءًا أساسيًا من تجربة المستخدم إضافة Google Meet. يمكنك إغلاق اللوحة الجانبية بعد المرحلة مفتوحة من خلال الاتصال unloadSidePanel

الترويج لإضافة Meet من خلال مشاركة الشاشة

تقدّم إضافات Meet تجربة أفضل من مشاركة الشاشة. ومع ذلك، اعتاد العديد من المستخدمين على استخدام ميزة مشاركة الشاشة في Meet. الجديدة. إذا شارك أحد المستخدمين علامة تبويب تعرض موقع الويب الذي يستضيف يمكن ضبط Meet على عرض بانر لجميع المشاركين في المكالمة يطلب منهم تثبيت على إضافة Meet المقابلة. لمزيد من المعلومات، يُرجى مراجعة الترويج للإضافة من خلال الشاشة التي تتم مشاركتها.