بما أنّ تجربة تسجيل الدخول هي أول تفاعل قد يجريه المستخدم مع الإضافة، من المهم أن يتمكّن من إكمال عملية تسجيل الدخول بسلاسة قدر الإمكان. اطّلِع على الأقسام أدناه للتعرّف على واجهات برمجة التطبيقات المختلفة لتسجيل الدخول، ومعلَمة طلب البحث ذات الصلة بتسجيل الدخول، وكيفية التعامل مع أدوات حظر النوافذ المنبثقة، وخطة اختبار يمكنك استخدامها أثناء التطوير لضمان اتّباع أفضل الممارسات.
تفاصيل تنفيذ الدخول المُوحَّد (SSO)
يتوافق بروتوكول OAuth 2.0 من Google مع العديد من حِزم OAuth 2.0. ننصحك بشدة بتنفيذ عملية التفويض من جهة الخادم لأنّها توفّر أعلى مستوى من الأمان وتتيح استخدام مَعلمات طلب البحث في iframe.
يُرجى الرجوع إلى الإرشادات الفنية المقدَّمة في موقع Google Identity الإلكتروني عند تنفيذ ميزة "تسجيل الدخول باستخدام Google". احرص على اتّباع إرشادات العلامة التجارية لتسجيل الدخول في Google. تتوفّر ملفات Sketch وSVG وEPS للتنزيل.
اختبارات تسجيل الدخول
استخدِم خطة الاختبار الخاصة بالإضافات للتأكّد من أنّ إضافتك تستوفي المعايير المطلوبة ويمكنها التعامل مع الحالات الحدّية المعروفة قبل إرسالها للمراجعة. تتطابق هذه الاختبارات بشكل كبير مع قائمة التحقّق من متطلبات إضافات Classroom، وتقدّم لك تعليمات مفصّلة حول كيفية التحقّق مما إذا كانت الإضافة تستوفي هذه المتطلبات. وهي الاختبارات نفسها التي يتم إجراءها على تطبيقك أثناء النشر.
مَعلمات طلب البحث لتسجيل الدخول
يوفّر Google Classroom مَعلمة طلب البحث login_hint للمساعدة في تسهيل
عملية تسجيل الدخول المتكرّرة. يمكنك الاطّلاع على قسم المَعلمات ذات الصلة بتسجيل الدخول في صفحة مَعلمات طلب البحث الخاصة بإطار iframe للحصول على معلومات إضافية. يمكنك العثور على نموذج الرمز البرمجي في شرح كيفية التعامل مع الزيارات المتكررة ضمن الشروحات الخاصة بالمطوّرين.
إدارة أدوات حظر النوافذ المنبثقة
يتم تسهيل عملية تسجيل الدخول إلى الإضافة من خلال نافذة مربّع حوار تسجيل الدخول. تعرض هذه النافذة شاشة اختيار الحساب وتسمح للمستخدم بمنح أذونات OAuth. قد يمنع برنامج حجب النوافذ المنبثقة لدى المستخدم النهائي إكمال عملية تسجيل الدخول.
الشكل 1. مثال على شاشة اختيار الحساب
لحلّ هذه المشكلة، يجب تزويد المستخدم النهائي بزر يمكنه النقر عليه لتجاوز أداة حظر النوافذ المنبثقة. يتيح هذا التفاعل عرض مربّع حوار تسجيل الدخول ليتمكّن المستخدم النهائي من مواصلة عملية تسجيل الدخول. تأكَّد من أنّ الزر الذي توفّره يتوافق مع إرشادات العلامة التجارية الخاصة بتسجيل الدخول.
اتّبِع دليل تسجيل الدخول في أدلة المطوّرين لتنفيذ زر تسجيل دخول يحمل علامة Google التجارية ويمكن النقر عليه لتفعيل مربّع حوار تسجيل الدخول.
تسجيل الدخول المتعدد
قد يؤدي المتصفّح الذي تم تسجيل الدخول فيه إلى حسابات متعددة في الوقت نفسه إلى تعطيل مسار المستخدم الخاص بالإضافة. يمكن للمستخدمين النهائيين إما تسجيل الخروج من جميع حسابات Google في المتصفّح الحالي أو فتح Classroom في نافذة "تصفّح متخفّي" على Chrome قبل تسجيل الدخول باستخدام الحساب الصحيح وإعادة محاولة العملية.
إذا تم تسجيل الدخول إلى الإضافة باستخدام حساب مستخدم غير صحيح بسبب مشكلة تسجيل الدخول المتعدد، قد يتعذّر عليك استدعاء واجهة برمجة التطبيقات لإضافات Classroom ويظهر الخطأ InvalidAddOnToken. في حال تلقّي هذا الخطأ، عليك توجيه المستخدم إما إلى تسجيل الخروج من جميع الحسابات الأخرى في المتصفّح أو فتح Classroom في نافذة تصفّح متخفي في Chrome بدلاً من ذلك.