الأسئلة الشائعة

عرض "واجبات المقرر الدراسي" وإنشاؤها وتعديلها في Classroom

ما الذي يمكنني إنشاؤه باستخدام نقاط نهاية CourseWork في Classroom API؟

تتيح نقاط النهاية للمطوّرين عرض العمل في صف وإدارته. وتحديدًا، يمكنك تنفيذ كلّ ما يلي:

  • عرض المهام والأسئلة (يُشار إليها إجمالاً باسم CourseWork) لمستخدم
  • إنشاء CourseWork وتعديلها وحذفها
  • إرفاق المواد (ملفات Drive وفيديوهات YouTube والروابط) بـ CourseWork
  • تغيير الحالة التي أرسلها الطالب (مثل التسليم أو الإرجاع أو الاستعادة)
  • ضبط درجة لإرسال مهمة
  • إرفاق المواد (ملفات Drive ومقاطع فيديو YouTube والروابط) إلى المهام التي أرسلها الطالب

في ما يلي بعض أمثلة حالات الاستخدام لـ CourseWork:

  • يمكن لتطبيقات "دفاتر العلامات" أو "نظام معلومات الطالب" أو أنظمة إعداد التقارير مزامنة المهام والعلامات من Classroom إلى تطبيقاتها، ما يغنيك عن نقل البيانات يدويًا
  • يمكن لتطبيقات التعلّم إنشاء مهام جديدة تظهر في ملف الصف. عندما يُكمل الطلاب عملهم، يمكن للتطبيقات تسليم العمل وتحديد الدرجات وإرفاق عمل الطلاب وتخزين العمل في مجلدات Drive المناسبة.
  • يمكن للمعلّمين إنشاء مهام باستخدام مرفقات إضافية من موقعك الإلكتروني أو تطبيقك.
  • يمكن للمستخدمين الطلاب إرسال مهامهم التي تتضمّن ملحقات الإضافة.

ما هي الأذونات التي يحتاجها تطبيقي لإنشاء مهام أو تعديلها؟

لا يمكن للتطبيق عادةً تعديل سوى العمل الذي ينشئه. بعبارة أخرى، يجب أن تستخدِم أي طلبات من واجهة برمجة التطبيقات لتعديل المهام رقم تعريف مشروع Google Cloud نفسه الذي تم تخزينه في وقت إنشاء المهمة.

تنطبق هذه القاعدة باستثناء إضافات Google Classroom. يمكن لمشروع Cloud الوصول إلى أي إعلان أو مهمة أو مادة تحتوي على مرفق واحد أو أكثر من المرفقات الإضافية أو تعديلها. يمكن أيضًا لمشروع في Google Cloud إرسال مهمة أو استردادها أو إرجاعها إذا كانت تتضمّن مرفقًا واحدًا أو أكثر من المرفقات الإضافية.

تتطلّب طلبات واجهة برمجة التطبيقات أيضًا نطاقات المستخدم الصحيحة. يمكن للمعلّمين الاطّلاع على المهام الدراسية وإنشاء المهام الدراسية وإرفاق روابط بالمهام الدراسية المرسَلة وتحديد الدرجات الممنوحة للمهام الدراسية. يمكن للطلاب عرض المهام الدراسية وإرفاق روابط بسجلّات المهام الدراسية وتسليم المهام الدراسية التي أرسلوها واستردادها. يمكن لمشرفي النطاق عرض CourseWork، ولكن ليس لديهم أذونات للكتابة.

ما هي أنواع العناصر التي يمكن لتطبيقي إرفاقها بالمهام أو العينات المرسَلة؟

تتيح واجهة برمجة التطبيقات إرفاق ملفات Drive وفيديوهات YouTube وروابط. لا يمكن إرفاق نماذج Google الأصلية بعد.

هل يعرف المستخدمون النهائيون أنّ تطبيقي هو الذي أنشأ المهام في Classroom؟

نعم. تتعرّف واجهة مستخدم Classroom على المهام التي تم إنشاؤها خارجيًا باستخدام اسم المنتج لمشروع Google Cloud الذي أنشأ العمل. يمكن للمستخدمين الإبلاغ عن العمل الذي تم إنشاؤه خارجيًا باعتباره غير مرغوب فيه، بالإضافة إلى إلغاء ربط التطبيق الذي أنشأ العمل، عن طريق إبطال أي بيانات اعتماد أصدرها المستخدم للتطبيق.

زر المشاركة في Classroom وعمليات الدمج الأخرى

لقد سبق أن دمجتُ تطبيقي مع زر المشاركة في Classroom. هل يمكنني تعديل مهمة تم إنشاؤها باستخدام زر المشاركة؟

ليس بعد. ولتعديل مهمة، يجب أن يستخدم الطلب مشروع Google Cloud نفسه الذي أنشأ المهمة.

هل يمكنني الإجابة عن الأسئلة في واجهة برمجة التطبيقات؟

ليس بعد. يمكنك إنشاء الأسئلة وتعديلها.

إضافات Classroom

إعدادات المشروع

هل يمكنني تحويل مشروع خاص على Google Cloud استخدمته أثناء التطوير إلى مشروع علني يمكنني استخدامه في مرحلة الإنتاج؟

لا يمكنك تحويل مشروع Google Cloud خاص إلى مشروع متاح للجميع. تحتاج إلى مجرّد مشروعَين منفصلَين، أحدهما للتطوير والآخر للنشر.

هل يمكن أن يتضمّن مشروع واحد على Google Cloud بيانات منتجَين في Google Workspace Marketplace؟

لا، لا يمكنك إنشاء بطاقة بياناتَين في Google Workspace Marketplace لمشروع واحد على Google Cloud.

مع ذلك، يمكنك تجميع الإضافات. يتيح ذلك إدراج ملف واحد في Google Workspace Marketplace يمثّل عدة إضافات. سيؤدي تثبيت من بطاقة بيانات كهذه إلى تثبيت جميع الإضافات في الحزمة في آنٍ واحد. على المستخدمين الموافقة على جميع النطاقات التي تحتاجها الإضافات المُدمَجة عند التفويض.

هل يمكن إعادة استخدام عميل OAuth من مشروع مختلف على Google Cloud مع مشروع على Google Cloud لإضافات Classroom؟

لا، لا يمكن استخدام برنامج OAuth من مشروع Google Cloud غير مشروع Google Cloud المخصّص لإضافة Classroom. ترفض Classroom API رموز الدخول التي تم إنشاؤها من خلال مشروع آخر على Google Cloud. يجب إنشاء عميل OAuth منفصل لمشروع الإضافة.

تجربة المستخدم

لا يتلاءم شعارنا بشكل جيد مع المربّع الصغير، فما خيارات الحجم المتاحة للشعارات في شريط عناوين iframe؟

تم تصميم شريط عنوان إطار iframe ليتوافق فقط مع شعار مربّع أبعاده 32×32. تمّ اتخاذ هذا الاختيار لمطابقة شكل رمز الشارة الذي تستخدمه الشركات على مواقعها الإلكترونية، وننصحك باستخدام الشعار نفسه في المساحة للحفاظ على اتساق العلامة التجارية.

النطاقات

هل يمكن لجميع المعلّمين والطلاب في النطاق نفسه الوصول إلى إحدى الإضافات المثبّتة؟

يمكن لمشرفي المؤسسات التعليمية التحكّم في المعلّمين الذين يمكنهم الاطّلاع على إضافة مثبّتة. لا يمكن استخدام إضافات Classroom إلا من قِبل المستخدمين الذين لديهم ترخيص Teaching & Learning أو Education Plus.

كيف يتفاعل مشرِفو النطاق مع الإضافات؟

يتحكّم مشرفي النطاق (المشرفون) في المستخدمين الذين يمكنهم استخدام الإضافة. يمكنهم تثبيت إضافة لنطاق كامل باستخدام خيار تثبيت المشرف. إذا كان بالإمكان تثبيت الإضافة بشكل فردي، يُرجى العِلم أنّ معظم المشرفين يحتفظون بقائمة مسموح بها للإضافة، ويمكن للمعلّمين تثبيت الإضافات لأنفسهم المدرَجة في هذه القائمة. قد يختار المشرف أيضًا تثبيت الإضافة بشكلٍ فردي لأغراض الاختبار.

قد يكون المشرفون أيضًا مهتمين بإحصاءات الاستخدام المتعلّقة بالإضافة. إذا كان منتجك يتيح هذا الخيار، نقترح عليك تقديم إحصاءات استخدام الإضافات في طريقة عرض المشرف على موقعك الإلكتروني.

واجهة برمجة التطبيقات

ما هي الطريقة الموثوق بها لمعرفة ما إذا كان يتم تحميل صفحة الشريك داخل إطار iframe أو علامة تبويب منبثقة؟

لا تتوفّر حاليًا طريقة للتمييز بين الاثنين.

ما هي عناصر العمل التي يمكن إسنادها والتي تحصل على إطار iframe لمراجعة عمل الطالب؟

لا يتوفّر عنصر iframe في "مراجعة أعمال الطلاب" إلا للمرفقات من النوع "نشاط". يمكنك استدعاء courses.courseWork.getAddOnContext method لمعرفة ما إذا كان نوع النشر يسمح بعرض أعمال الطلاب. يمكن أن يكون حقل supportsStudentWork هو true فقط لنوع المشاركة الذي يمثّل نشاطًا.

هل يمكن لمرفق إضافة الوصول إلى عنصر ساحة المشاركات المرفق به؟

نعم. يمكنك get أو patch أي Announcement أو CourseWork أو CourseWorkMaterial يحتوي على مرفق واحد على الأقل من الإضافات. يمكنك reclaim أو return أو turnIn CourseWork StudentSubmission.

الدخول المُوحَّد

نعم، لا يزال بإمكانهم استخدام ميزة "تسجيل الدخول باستخدام حساب Google".

هل لدى كل طالب عنوان بريد إلكتروني منسَّق بشكل صحيح، حتى إذا لم يكن لديه إذن الوصول إلى Gmail؟

يمتلك كل مستخدم في Google Workspace for Education هوية Google، بغض النظر عمّا إذا كان بإمكانه الوصول إلى Gmail. يتم تمثيل الهويات باستخدام عنوان بريد إلكتروني. هناك اختلاف بين الهوية وإمكانية الوصول إلى أي خدمة معيّنة من خدمات Google (بما في ذلك Gmail). وبالتالي، حتى إذا تم إيقاف Gmail، يمكن للمستخدمين الطلاب تسجيل الدخول باستخدام عنوان بريدهم الإلكتروني.

هل يحتاج مشرف المؤسسة التعليمية إلى الموافقة مسبقًا على التطبيق للسماح للطلاب بتسجيل الدخول؟

على مشرفي النطاق إضافة الإضافة إلى القائمة المسموح بها قبل أن يتم تثبيتها. يمكن لمشرفي النطاق تثبيت إضافة اختيارية لجميع المستخدمين ضمن النطاق أو وحدة تنظيمية.

الملاحظات والأسئلة العامة

كيف يمكنني إرسال طلبات ميزات أو طلب مشاكل؟

يمكنك إرسال طلبات الميزات وعرضها والتصويت عليها من خلال أداة تتبّع المشاكل العامة.

كيف يمكنني معرفة متى تصبح ميزات جديدة متاحة في Classroom API؟

يتم نشر تحديثات واجهة برمجة التطبيقات على صفحة ملاحظات الإصدار ومنتدى المطوّرين وأداة تتبُّع المشاكل المتاحة للجميع.

أستخدم Classroom API. كيف يمكنني طرح أسئلة فنية؟

يمكنك نشر أسئلتك على Stack Overflow باستخدام علامة google-classroom.