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