يوفّر هذا الدليل نظرة عامة على المكوّنات الأساسية التي تشكّل Google Classroom API. تتألف Google Classroom API من موارد وخدمات. تمثّل الموارد الكيانات في Google Classroom، مثل دورة تدريبية أو مهمة، وتعمل الخدمات على استرداد هذه الموارد وإدارتها. تحتوي بعض هذه الكيانات على سمات إضافية خاصة بواجهة برمجة التطبيقات بالإضافة إلى ما هو متوفّر في Classroom. في ما يلي أنواع الكيانات الأساسية:
| الكيان | التمثيل في Classroom |
|---|---|
| الدورات التدريبية | فئة، مثل "م. "الصف الرابع في مادة الرياضيات لسميرة". |
| الأسماء البديلة | معرّف بديل لدورة دراسية. |
| الدعوات | وسيلة لإضافة مستخدمين إلى صف |
| الطلاب | طالب في صف دراسي |
| المعلّمون | معلّم في صف |
| الملفات الشخصية للمستخدمين | يشير إلى المستخدم بشكل عام، خارج سياق الطالب أو المعلّم. |
| CourseWork | مهمة في صف |
| StudentSubmissions | عمل الطلاب في مهمة معيّنة، مثل الإجابات أو أوراق البيانات |
| CourseWorkMaterials | مواد للطلاب في صف دراسي |
| الإعلانات | إشعار موجَّه إلى الطلاب في صف دراسي |
| AddOnAttachment | محتوى أو نشاط في مهمة أو مادة يتم عرضهما عادةً كإطار iframe مضمّن |
| المواضيع | تجميع مرئي للمهام والمواد في صف |
| عمليات التسجيل | تعليمات لإرسال إشعارات إلى تطبيقك بشأن التغييرات في البيانات، مثل قائمة صف |
تحتوي معظم الموارد على طرق خدمة للعمليات العادية، مثل قراءة مثيلات المورد وتعديلها وحذفها. تحتوي بعض الموارد أيضًا على methods مخصّصة لعمليات أخرى، مثل تعديل قائمة الطلاب الذين تم تعيين مهمة معيّنة لهم.
للحصول على معلومات تفصيلية عن موارد واجهة برمجة التطبيقات وطُرقها، يُرجى الرجوع إلى مرجع Classroom API.
نظرة عامة على علاقات الموارد
- الدورة التدريبية هي عنصر البيانات الأساسي في Google Classroom.
- تُستخدَم الأسماء البديلة كمعرّفات بديلة لـ
Courses. - تُستخدَم الدعوات لدعوة الملفات الشخصية للمستخدمين لتصبح معلّمين
أو طلابًا في
Course، ولكن يمكن أيضًا إضافة المستخدمين مباشرةً من قِبل مشرفي نطاق Google Workspace for Education. - ينشئ المعلّمون عناصر بث ويشاركونها مع الطلاب في
دوراتهم الدراسية. وأنواع عناصر البث المحتمَلة هي المهام الدراسية،
مواد المهام الدراسية،
الإشعارات. يمكن
تنظيم
CourseWorkوCourseWorkMaterialsبشكل مرئي في المواضيع، ويمكن أن تحتوي على AddOnAttachments. يرسل الطلاب StudentSubmissions لملفهم الشخصيCourseWork. - يمكن للمطوّرين إنشاء عمليات تسجيل لتلقّي إشعارات عند تغيُّر بعض هذه البيانات.
يتوفّر Google Classroom للنطاقات التي تشترك في Google Workspace for Education. يمثّل النطاق في سياق Classroom عادةً منطقة دراسية. يمكنك إنشاء نطاق اختبار في Google Workspace for Education لأغراض تطوير التطبيقات، ما يتيح لك التحكّم في مثيل علني من Classroom بدون التأثير في المستخدمين الفعليين.
الدورات التدريبية والعناوين البديلة
يمثّل الرمز Courses فئة، مثل "M. "الصف الرابع في مادة الرياضيات في مدرسة سميث"،
ومعلّمو الصف وقائمة الطلاب وبيانات التعريف يتم تحديد كل دورة تدريبية من خلال
معرّف فريد يحدّده الخادم. يضمّن مورد Course تحديدًا
جميع البيانات الوصفية حول الدورة التدريبية، مثل الاسم
والوصف والموقع الجغرافي والوقت. تتم إدارة قوائم الطلاب في الدورات التدريبية من خلال موارد
الطالب والمعلّم والدعوة
وطرقها.
Aliases هي معرّفات بديلة لفئة قد تكون مرتبطة بدورة تدريبية
ويتم استخدامها بدلاً من المعرّف الفريد. يتوفّر كل عنوان بديل في مساحة اسم محدودة
بمن يمكنه إنشاؤه وعرضه. تتوفّر مساحتَا أسماء:
- النطاق: تكون مساحة أسماء النطاق مفيدة لإنشاء أسماء بديلة يحتاج إليها جميع المستخدمين، ولكنّها ليست خاصة بأي برنامج واحد. على سبيل المثال، يجب إنشاء إدراجات بديلة لدورة تدريبية، مثل MATH 127 وCOMSCI 127، في مساحة أسماء النطاق. يمكن لمشرفي النطاق فقط إنشاء الأسماء البديلة في مساحة اسم النطاق، ولكنها تكون مرئية لجميع المستخدمين في النطاق.
- مشروع المطوّر: تكون مساحة اسم مشروع المطوّر مفيدة في إدارة الأسماء البديلة الخاصة بتطبيق معيّن. على سبيل المثال، يمكن لتطبيقٍ يستخدم معرّفات بديلة للدورات إنشاء أسماء بديلة لربط معرّفه بدورات Classroom. إنّ الأسماء البديلة التي تم إنشاؤها في هذا النطاق مرتبطة بحساب معيّن على Google API Console. يمكن لأي مستخدم لتطبيق إنشاء أسماء بديلة وعرضها في مساحة الاسم لمشروع المطوّر الخاص بالتطبيق.
لمزيد من المعلومات عن إدارة البيانات الوصفية للدورة التدريبية والأسماء البديلة، يُرجى الاطّلاع على مقالة إدارة الدورات التدريبية.
قوائم الطلاب المسجّلين في الدورات والمستخدمون
Students وTeachers هما ربطان محدّدان بين ملف شخصي للمستخدم ودورة تدريبية، ويمثّلان دور هذا المستخدم في الدورة التدريبية. إنّ تصنيفات "طالب" و"معلّم" ليست عالمية: يمكن تعيين مستخدم كمعلّم في دورة تدريبية وطالبًا في دورة أخرى. يمثّل التصنيف "طالب" أو "معلم" مجموعة من
الأذونات لمستخدم معيّن في دورة تدريبية معيّنة. يمكن أن تتضمّن الدورة التدريبية أكثر
من معلّم واحد أو لا تتضمّن أي طلاب. يمكن إضافة المعلّمين والطلاب إلى دورة تدريبية أو
إزالتهم منها في أي وقت.
- الطلاب
يمثّل مورد
Studentمستخدمًا مسجّلاً كطالب في دورة تدريبية معيّنة.يُسمح للطلاب بالاطّلاع على تفاصيل الدورة وأسماء المعلّمين فيها.
- المعلمون
يمثّل مورد
Teacherمستخدمًا يقدّم دورة تدريبية معيّنة.يُسمح للمعلّمين بالاطّلاع على تفاصيل الدورة التدريبية وتغييرها، والاطّلاع على المعلّمين والطلاب، وإدارة المعلّمين والطلاب الإضافيين.
Invitations وطرقها المرتبطة بها توفّر طريقة ملائمة لإضافة
الطلاب والمعلّمين إلى الدورات التدريبية. يتيح إنشاء الدعوات للمستخدمين اختيار
ما إذا كانوا يريدون الانضمام إلى دورة تدريبية أم لا، بدلاً من إضافتهم مباشرةً من خلال
موارد المعلّمين والطلاب.
يمثّل العنصر UserProfiles عملية ربط بملف تعريف نطاق المستخدم كما هو محدّد من خلال
رقم التعريف الفريد أو عنوان البريد الإلكتروني للمستخدم الذي تعرضه
Directory API. يمكن للمستخدم الحالي أيضًا الإشارة إلى
رقم تعريفه باستخدام الاختصار "me".
يمكن أيضًا استخدام خدمة UserProfiles لإدارة Guardians ودعوته، وهو ربط بين الطالب والوصي. يمكن للأوصياء في
Classroom الوصول إلى بعض معلومات الطلاب، مثل assignments (المهام).
لمزيد من المعلومات عن إدارة قوائم المستخدمين، يُرجى الاطّلاع على مقالة إدارة المعلّمين والطلاب.
عناصر البث
عناصر البث هي أجزاء من المحتوى المنشور التي تتم مشاركتها مع أعضاء الدورة التدريبية.
يمكن للمطوّرين والمعلّمين إنشاء ثلاثة أنواع من عناصر البث: Announcement
CourseWork وCourseWorkMaterial.
ينشئ المعلّمون Announcements في أعلى صفحة "ساحة المشاركات" في واجهة مستخدم
Classroom. ينشئ المعلّمون CourseWork و
CourseWorkMaterials من خلال النقر على الزر إنشاء في علامة التبويب "الواجب الدراسي".
يمكن للمطوّرين إنشاء جميع أنواع عناصر البث آليًا من خلال واجهة برمجة التطبيقات
Classroom API.
في ما يلي الشروط التي يجب أن تستوفيها عناصر البث:
- يمكن أن تحتوي جميع عناصر البث على مواد تكميلية، مثل ملفات Google Drive وفيديوهات YouTube و"نماذج Google" والروابط الفائقة لعناوين URL ومرفقات إضافات Classroom.
- يمكن تخصيص كل عناصر البث لمجموعة فرعية من الطلاب في الدورة التدريبية.
- يمكن أن يكون التقييم
CourseWorkمصحوبًا بدرجات أو بدون درجات. يمكن للمعلّمين تغيير حالةCourseWorkمهمة تقييم في أي وقت. - يمكن أن يتضمّن عنصر البث أكثر من مرفق واحد.
- قد يحتوي عنصر البث على مرفقات من أنواع مختلفة. على سبيل المثال، قد تحتوي مهمة واحدة
CourseWorkعلى ملفات Google Drive وفيديوهات على YouTube ومرفقات إضافة Classroom في الوقت نفسه. - قد يتضمّن عنصر البث مرفقات إضافية من أكثر من مطوّر واحد.
- يمكن للمطوّرين الحصول على تفاصيل عن أيّ مورد لعنصر بث يتضمّن أحد مرفقات الإضافات الخاصة بهم وتعديلها.
- يمكن للمطوّرين تسليم عمل الطالب أو استرجاعه أو إرجاعه في مهمة
CourseWorkتتضمّن أحد مرفقات الملحقات. - لا يمكن للمطوّرين وضع الدرجات النهائية إلا للمهام الفردية التي أرسلها الطلاب في assignments التي أنشأوها.
عناصر البث التي تم نسخها
يمكن للمعلّمين نسخ عنصر بث من خلال نسخ دورة تدريبية أو إعادة استخدام مهمة أو نشر عنصر بث في دورات تدريبية متعددة. وستحتوي أي نُسخ جديدة على معرّفات مختلفة، ما قد يكون عاملاً مهمًا في حال كنت تُطوّر إضافة لتطبيق Classroom. اطّلِع على دليلنا حول المحتوى المنسوخ لفهم كيف يمكن لإضافة التعامل مع هذه السيناريوهات.
CourseWork وStudentSubmissions
يمثّل عنصر CourseWork مهمة لمجموعة من الطلاب في أحد
الدورات التدريبية. وهو نوع عنصر البث الوحيد الذي يمكنه قبول المحتوى الذي يرسله الطلاب. يحتوي مورد
CourseWork على تفاصيل مثل الوصف وتاريخ الاستحقاق
والحد الأقصى للدرجة والبيانات الوصفية، مثل وقت الإنشاء.
يصف كلّ مورد CourseWork أحد الأنواع التالية من المهام:
- مهمة يكملها الطلاب من خلال إرسال جداول بيانات أو مرفقات أخرى.
- سؤال ذي إجابة قصيرة أو سؤال ذي خيارات متعدّدة
يتم تمثيل عمل الطالب في عنصر CourseWork برمز StudentSubmission. ويتألّف
من استجابة وبيانات وصفية إضافية، مثل الحالة والدرجة المخصّصة.
تعتمد محتويات StudentSubmission على نوع العنصر
CourseWork المقابل لها، ويمكن أن تشمل ما يلي:
- جداول البيانات والمرفقات التي تم إرسالها لمهمة معيّنة، بما في ذلك العنوان والصورة المصغّرة وعنوان URL، بالإضافة إلى المعرّفات التي يمكن استخدامها مع واجهات برمجة التطبيقات المناسبة، مثل Drive أو YouTube
- ردّ على سؤال ذي إجابة قصيرة أو سؤال خيارات متعدّدة
لمزيد من المعلومات عن إدارة المهام الدراسية والمهام التي يرسلها الطلاب، يُرجى الاطّلاع على مقالة إدارة المهام الدراسية.
مواد الدورة التدريبية والإشعارات
على غرار CourseWork، يمثّل CourseWorkMaterials المحتوى الذي تمّ تعيينه
لمجموعة من الطلاب في دورة تدريبية. يتضمّن كل مرجع تفاصيل مثل العنوان
والوصف بالإضافة إلى مواد تكميلية. ومع ذلك، على عكس CourseWork،
لا تتطلّب CourseWorkMaterials من الطلاب إرسال أيّ عناصر. وبناءً على ذلك،
لا يتوفّر تاريخ استحقاق، ولا يتوفّر StudentSubmissions لملف
CourseWorkMaterials. قد يستخدم المعلّمون CourseWorkMaterials لنشر
مواد القراءة المقترَحة أو المنهج الدراسي أو قواعد الصف.
تمثّل Announcements أيضًا المحتوى الذي تمت مشاركته مع مجموعة من الطلاب، ولكن
لا تتضمّن تفاصيل مثل العنوان، ولا يمكن تنظيمها حسب Topics مثل
CourseWork أو CourseWorkMaterials. وقد يستخدم المعلّمون هذه الميزة لإرسال تذكيرات أو إشعارات إلى الصف.
المواضيع
تُستخدَم Topics لتنظيم CourseWork وCourseWorkMaterials visually
ضمن فئة. ويمكن استخدامها لتجميع المهام في "اختيارية" و
"مطلوبة"، أو "الوحدة 1" و "الوحدة 2"، على سبيل المثال.
إضافات Classroom
الإضافات هي واجهة مستخدِم وخلفية يقدّمها المطوّرون ويتم عرضها عادةً في ملف vimeframe. تظهر الإضافات كمرفقات في عنصر البث. يمكن أن يكون عنصر البث
أي Announcements أو CourseWork أو CourseWorkMaterials. يتم تمثيل مرفقات الإضافة
برمز AddOnAttachment.
يمكن أن تكون مرفقات الإضافات نشاطًا أو محتوى.
- تتطلّب مرفقات الأنشطة من الطالب إكمال ملف إرسال شخصي وتسليمه. وتشمل الأمثلة الاختبارات أو الرسومات أو الألعاب. يمكن اختياريًا وضع علامات على العينة المرسَلة.
- لا تتطلّب مرفقات المحتوى إرسال الطلاب لها. ولا يحتاج الطالب إلى إرسال المرفق ولن يتم وضع درجة له. وتشمل الأمثلة الصور ومقالات وفيديوهات.
اطّلِع على دلائل تطوير الإضافات للحصول على مزيد من المعلومات.
تسجيلات
يمكن للتطبيقات الاشتراك في الإشعارات عند تغيُّر بيانات معيّنة في
Google Classroom. على سبيل المثال، عند تعديل قائمة الطلاب في دورة تدريبية.
يمثّل Registrations تعليمات لإرسال هذه الإشعارات إلى
تطبيقك.
اطّلِع على دليل الإشعارات الفورية لمعرفة المزيد.