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

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

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

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

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

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

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

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

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

تُستثنى إضافات Google Classroom من هذه القاعدة. يمكن لمشروع Cloud الوصول إلى أي إعلان أو مهمة أو مادة تحتوي على واحد أو أكثر من مرفقاتها الإضافية أو تعديلها. يمكن أيضًا لمشروع 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.