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