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

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

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

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

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

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

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

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

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

تستثنى إضافات 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 الخاص بإضافات Classroom؟

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

النطاقات

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

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

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

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

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

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

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

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

ما هي عناصر العمل القابلة للتخصيص التي تحصل على إطار iframe لمراجعة عمل الطالب؟

لا يتم توفير إطار iframe الخاص بمراجعة عمل الطالب إلا للمرفقات من نوع النشاط. استدعِ courses.courseWork.getAddOnContextالطريقة لمعرفة ما إذا كان نوع المشاركة يتيح إرفاق عمل الطالب. يمكن أن يكون الحقل supportsStudentWork true فقط لنشر نوع نشاط.

هل يمكن لمرفق إضافة الوصول إلى عنصر البث المرفق به؟

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

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

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

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

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

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

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

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

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

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

كيف يمكنني معرفة موعد توفّر ميزات جديدة في Classroom API؟

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

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

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