عرض CourseWork وإنشاؤها وتعديلها في Classroom
ما الذي يمكنني إنشاؤه باستخدام نقاط نهاية CourseWork في واجهة برمجة تطبيقات Classroom؟
تتيح نقاط النهاية الجديدة للمطوّرين عرض العمل في الصف وإدارته. على وجه التحديد، يمكنك القيام بكل ما يلي:
- عرض المهام والأسئلة (يشار إليها مجتمعة باسم "CourseWork") لمستخدم
- إنشاء CourseWork وتعديلها وحذفها
- إرفاق المواد (ملفات Drive ومقاطع فيديو YouTube والروابط) بـ CourseWork
- تغيير حالة العينة التي أرسلها الطالب (مثل تسليم المهمة أو إرجاعها أو استردادها)
- تحديد الدرجة لأحد المهام الدراسية المرسَلة
- إرفاق المواد (ملفات Drive ومقاطع فيديو YouTube والروابط) إلى مهام الطلاب
بعض نماذج حالات استخدام CourseWork:
- يمكن لدفاتر العلامات أو نظام معلومات الطالب أو أنظمة إعداد التقارير مزامنة المهام والدرجات من Classroom إلى تطبيقاتها، ما يلغي نقل البيانات يدويًا.
- يمكن لتطبيقات التعلم إنشاء مهام جديدة تظهر في ساحة الفصل الدراسي. وعندما يُكمل الطلاب العمل، يمكن للتطبيقات تسليم العمل وتحديد الدرجات وإرفاق عمل الطالب وتخزين العمل في مجلدات Drive المناسبة.
- يمكن للمستخدمين المعلمين إنشاء مهام دراسية بمرفقات الإضافات من موقعك الإلكتروني أو التطبيق.
- يمكن للمستخدمين الطلاب تسليم المهام الدراسية التي تحتوي على مرفقات الإضافات الخاصة بك.
ما هي الأذونات التي يحتاجها تطبيقي لإنشاء مهام أو تعديلها؟
عادةً، يمكن للتطبيق تعديل العمل الذي ينشئه فقط. بعبارة أخرى، يجب أن تستخدم أي طلبات من واجهة برمجة التطبيقات لتغيير المهمة رقم تعريف مشروع Google Cloud نفسه الذي تم تخزينه في وقت إنشاء المهمة.
تُستثنى إضافات Google Classroom من هذه القاعدة. يمكن للمشروع على السحابة الإلكترونية الوصول إلى أي إعلانات أو مهمة أو مادة تحتوي على واحد أو أكثر من مرفقات الإضافات الخاصة به، أو تعديل أي منها. يمكن أيضًا للمشروع على السحابة الإلكترونية تسليم مهمة أو استردادها أو إرجاعها التي تحتوي على مرفق واحد أو أكثر من الإضافات التابعة له.
تتطلب طلبات البيانات من واجهة برمجة التطبيقات أيضًا نطاقات المستخدم الصحيحة. يمكن للمعلّمين عرض المهام وإنشاء المهام وإرفاق الروابط بعمليات الإرسال وتحديد درجات المهام. يمكن للطلاب عرض المهام الدراسية وإرفاق روابط بسجلات المهام الخاصة بهم، ثم تسليم المهام واستردادها. يمكن لمشرفي النطاق عرض CourseWork، ولكن ليس لديهم أذونات للكتابة.
ما هي أنواع العناصر التي يمكن أن يرفقها طلبي بالمهمة أو المهام المُرسَلة؟
تتيح واجهة برمجة التطبيقات إرفاق ملفات Drive وفيديوهات YouTube والروابط. لا تتوفر حتى الآن إمكانية إرفاق "نماذج Google" الأصلية.
هل يعرف المستخدمون النهائيون أنّ تطبيقي قد أنشأت المهام الدراسية في Classroom؟
نعم. تحدد واجهة مستخدم Classroom المهام التي تم إنشاؤها خارجيًا باستخدام اسم المنتج لمشروع Google Cloud الذي أنشأ العمل. يمكن للمستخدمين الإبلاغ عن العمل الذي تم إنشاؤه خارجيًا باعتبارها غير مرغوب فيها، بالإضافة إلى إلغاء ربط التطبيق الذي أنشأ العمل، من خلال إبطال أي بيانات اعتماد أصدرها المستخدم للتطبيق.
زر المشاركة في Classroom وعمليات الدمج الأخرى
لقد سبق أن تم دمج زر المشاركة في Classroom. هل يمكنني تعديل مهمة تم إنشاؤها باستخدام زر المشاركة؟
لا يمكن ذلك الآن. لتعديل مهمة دراسية، يجب أن يستخدم الطلب مشروع Google Cloud نفسه الذي أنشأ هذه المهمة.
هل يمكنني الإجابة عن الأسئلة في واجهة برمجة التطبيقات؟
لا يمكن ذلك الآن. يمكنك إنشاء أسئلة وتعديلها. إن الإجابة عن الأسئلة آليًا في خارطة الطريق لدينا.
إضافات Classroom
إعدادات المشروع
هل يمكنني تحويل المشروع الخاص على Google Cloud الذي استخدمته أثناء التطوير إلى مشروع عام يمكنني استخدامه في الإنتاج؟
لا يمكنك تحويل مشروع خاص على Google Cloud إلى مشروع عام. أنت بحاجة إلى مشروعين منفصلين، أحدهما للتطوير والآخر للإنتاج.
هل يمكن أن يتضمّن مشروع واحد على Google Cloud بطاقتَي بيانات GWM؟
لا، لا يمكنك إنشاء بطاقتَي بيانات GWM لمشروع واحد على Google Cloud.
ومع ذلك، من الممكن تجميع الإضافات. يسمح ذلك لقائمة بيانات GWM واحدة بتمثيل إضافات متعددة. سيؤدي التثبيت من بطاقة بيانات المتجر هذه إلى تثبيت جميع الإضافات في الحزمة مرة واحدة. سيحتاج المستخدمون إلى الموافقة على جميع النطاقات التي تتطلبها الإضافات المجمّعة عند التفويض.
هناك اعتباران إضافيان في ما يتعلق بالتجميع:
لا تتوفّر إضافات Classroom إلا للمشتركين في Teaching & Learning Upgrade أو Education Plus SKU.
تتوفّر واجهة برمجة التطبيقات للإضافات في إطار استخدام المنتج قبل إطلاقه، وتقتصر على المطوّرين المشاركين في البرنامج ومشاريع Google Cloud. قد لا تعمل الإضافات المجمَّعة على النحو المنشود إذا كانت تعتمد على مشاريع Google Cloud غير المشاركة.
هل يمكن إعادة استخدام عميل OAuth من مشروع مختلف على Google Cloud مع مشروع Google Cloud لإضافةات Classroom؟
لا، لا يمكن أن يعمل عميل OAuth من مشروع Google Cloud بخلاف مشروع Google Cloud لإضافة Classroom. يتم رفض رموز الدخول التي تم إنشاؤها بواسطة مشروع Google Cloud آخر بواسطة Classroom API. يجب إنشاء عميل OAuth منفصل لمشروع الإضافة.
تجربة المستخدم
لا يتلاءم شعارنا بشكل جيد مع مربّع صغير، فما هي خيارات الحجم المتوفرة للشعارات في شريط عنوان إطار iframe؟
تم تصميم شريط عناوين إطار iframe ليتوافق مع شعار مربّع مقاس 32x32 فقط. تم تحديد هذا الخيار ليتناسب مع شكل الرمز المفضّل الذي تستخدمه الشركات على مواقعها الإلكترونية، ونحن نستند إلى إرشاداتنا حول استخدام الشعار نفسه في المساحة لتحقيق اتساق العلامة التجارية.
النطاقات
هل يمكن لجميع المعلّمين والطلاب في النطاق نفسه الوصول إلى إضافة مثبَّتة؟
ويملك مشرفو المؤسسات التعليمية إمكانية تحديد المعلّمين الذين يمكنهم الاطّلاع على الإضافة المثبّتة.
كيف يتفاعل مشرفو النطاقات مع الإضافات؟
يتحكم مشرفو النطاق (المشرفون) في الأشخاص الذين يمكنهم استخدام الإضافة. يمكنهم تثبيت إضافة لنطاق بأكمله باستخدام خيار التثبيت للمشرف. إذا كان من الممكن تثبيت الإضافة بشكل فردي، يُرجى العِلم أنّ معظم المشرفين يحتفظون بالقائمة المسموح بها للإضافات، ويمكن للمعلّمين تثبيت الإضافات بأنفسهم المدرجة في هذه القائمة. قد يختار المشرف أيضًا تثبيت الإضافة بشكل فردي لأغراض الاختبار.
قد يهتم المشرفون أيضًا بإحصاءات الاستخدام المتعلقة بالإضافتك. يمكنك تقديم إحصاءات استخدام الإضافة بطريقة عرض المشرف على موقعك الإلكتروني، إذا كان المنتج يتيحها.
API
ما هي الطريقة الموثوقة لمعرفة ما إذا تم تحميل صفحة الشريك داخل إطار iframe أو علامة تبويب منبثقة؟
ولا توجد طريقة حالية للتمييز بين الاثنين.
ما هي عناصر العمل القابلة للتعيين والتي تحصل على إطار iframe لمراجعة عمل الطلاب؟
يتم توفير إطار iframe لمراجعة عمل الطلاب للمرفقات من نوع النشاط فقط.
عليك استدعاء طريقة courses.courseWork.getAddOnContext لمعرفة ما إذا كان نوع المشاركة يدعم عمل الطالب. يمكن استخدام true في الحقل supportsStudentWork لنوع المشاركة فقط.
هل يمكن أن تحدث تغييرات قد تؤدي إلى تعطُّل واجهة برمجة التطبيقات خلال فترة استخدام برنامج استخدام المنتج قبل إطلاقه؟
لا تزال واجهة برمجة التطبيقات للإضافات قيد التطوير. لذلك، قد تكون هناك تغييرات قد تؤدي إلى تعطُّل واجهة برمجة التطبيقات، ما يؤدي إلى تعذُّر معالجة الطلبات الناجحة في السابق أو التصرف بشكل مختلف. ويمكنك تلقّي إشعار مسبق بأي تغييرات قد تؤدي إلى عطل من خلال منتدى المطوّرين.
هل يمكن لمرفق إضافة الوصول إلى عنصر البث المرفق به؟
نعم. يمكنك get أو patch أي Announcement أو CourseWork أو
CourseWorkMaterial تتضمّن مرفقًا واحدًا على الأقل من مرفقات الإضافات.
يمكنك reclaim أو return أو turnIn CourseWork StudentSubmission.
متى سيتم طرح إضافات Classroom للجميع؟
تتوفّر إضافات Classroom لجميع المستخدمين النهائيين منذ صيف 2022. ومن المتوقّع أن تكون واجهة برمجة التطبيقات للإضافات متاحة بشكلٍ عام للمطوّرين في وقت ما من عام 2024.
تسجيل الدخول الأحادي
هل يمكن للطلاب الذين يستخدمون شارات Clever أو Classlink لتسجيل الدخول إلى أجهزة Chromebook استخدام ميزة "تسجيل الدخول بحساب Google"؟
نعم، سيظل بإمكانه استخدام ميزة "تسجيل الدخول بحساب Google".
هل لدى كل طالب عنوان بريد إلكتروني مكتوب بشكل صحيح، حتى إذا لم يكن لديه إمكانية الوصول إلى Gmail؟
يمتلك كل مستخدم في Google Workspace for Education هوية Google، بغض النظر عمّا إذا كان بإمكانه الوصول إلى Gmail أم لا. يتم تمثيل الهويات بعنوان البريد الإلكتروني. تختلف الهوية وإمكانية الوصول إلى أي خدمة من خدمات Google (بما في ذلك Gmail). لذا، حتى إذا تم إيقاف Gmail، يمكن للمستخدمين الطلاب تسجيل الدخول باستخدام عنوان بريدهم الإلكتروني.
هل يحتاج مشرف المؤسسة التعليمية إلى الحصول على موافقة مسبقة على التطبيق للسماح للطلاب بتسجيل الدخول؟
على مشرفي النطاقات إضافة إضافة إلى القائمة المسموح بها قبل تثبيتها. اختياريًا، يمكن لمشرفي النطاق تثبيت إضافة لجميع المستخدمين داخل النطاق أو وحدة تنظيمية.
ملاحظات وأسئلة عامة
كيف يمكنني إرسال طلبات ميزات أو الطلبات؟
يمكنك إرسال طلبات الميزات وعرضها والتصويت عليها من خلال أداة تتبّع المشاكل العامة.
كيف يمكنني معرفة ما إذا كانت الميزات الجديدة متاحة في Classroom API؟
يتم نشر التحديثات على واجهة برمجة التطبيقات على صفحة ملاحظات الإصدار ومنتدى المطوّرين وأداة تتبّع المشاكل العامة.
أستخدم Classroom API. كيف يمكنني طرح أسئلة فنية؟
يمكنك نشر أسئلتك على Stack Overflow باستخدام العلامة google-classroom.