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