بما أن تجربة تسجيل الدخول هي أول تفاعل قد يقوم به المستخدم مع الإضافية، فمن المهم أن يتمكنوا من إكمال التدفق بسلاسة ممكن. يُرجى الاطّلاع على الأقسام التالية للتعرّف على مختلف واجهات برمجة التطبيقات لتسجيل الدخول، ومعلمة طلب البحث ذي الصلة بتسجيل الدخول، وكيفية التعامل مع أدوات حظر النوافذ المنبثقة، وخطة اختبار يمكنك استخدامها أثناء التطوير للتأكد من أنك تتبع وأفضل الممارسات.
تفاصيل تنفيذ الدخول المُوحَّد (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 بدلاً من ذلك.