توفّر Google Classroom API واجهة برمجة لصنّاع البرامج والمشرفين وقادة المؤسسات التعليمية لإدارة موارد Google Classroom. يمكنك إنشاء برامج لإنشاء دورات Classroom ومحتوى الدورات واستردادها وتعديلها.
تشمل بعض حالات الاستخدام الشائعة ما يلي:
- إدارة الدورات التدريبية وقوائم الطلاب المسجّلين والأوصياء
- إضافة المهام الدراسية والإشعارات ومواد الدورة التدريبية
- منح الدرجات وتعديل إعدادات وضع الدرجات
- إنشاء بيانات للتحليل
- إتاحة المحتوى أو الأدوات من مقدّم خارجي للاكتشاف والوصول إليها داخل Classroom
هل واجهة برمجة التطبيقات Classroom API هي الحلّ المناسب لي؟
توفّر Google العديد من المنتجات لمساعدتك في التفاعل مع Classroom. في ما يلي بعض السيناريوهات الشائعة ومقترَحات بشأن المنتجات التي قد تناسب احتياجاتك على أفضل وجه.
تعديل مراجع Google Classroom
| السيناريو | الحلول المقترَحة |
|---|---|
| أريد إدارة عددٍ كبيرٍ من الدورات التدريبية أو المستخدمين أو موارد Classroom الأخرى بانتظام. أشعر بالراحة عند كتابة الرموز البرمجية وصيانة البنية الأساسية للبرامج. | كتابة تطبيقات تستخدِم Classroom API |
| أريد إدارة عدد صغير من موارد Classroom من حين لآخر. أشعر بالارتياح عند كتابة كميات صغيرة من الرموز البرمجية مع القليل من التكاليف الإضافية. | استخدام Classroom API مع برمجة تطبيقات Google |
| أريد إجراء تغييرات من حين لآخر على موارد Classroom الفردية. أشعر بالارتياح عند استخدام أوامر وحدة التحكّم. | استخدِم مدير تطبيقات Google. |
| أريد الحصول على عدد كبير من التقارير التي تتضمّن تفاصيل عن الأحداث في Classroom. | استخدِم خدمة نقل البيانات في BigQuery. |
| أريد إجراء تحقيق في نشاط المستخدمين. | يمكنك إنشاء التقارير في وحدة تحكّم المشرف أو استخدام Reports API. |
الدمج مع Google Classroom
| السيناريو | الحلول المقترَحة |
|---|---|
| أريد أن يتمكّن المعلّمون والطلاب من الاطّلاع على المحتوى الخاص بي وتشغيله في Classroom. | أنشئ إضافة Classroom. |
| أريد أن ينقر المعلّمون على زر في موقعي الإلكتروني أو تطبيقي يؤدي إلى تضمين المحتوى في Classroom. | يمكنك إنشاء إضافة Classroom وإنشاء مرفقات برمجيًا. |
| أريد أن ينقر المعلّمون على زر في موقعي الإلكتروني أو تطبيقي للربط بموادي التعليمية في Classroom. | إنشاء أعمال دراسية باستخدام واجهة برمجة التطبيقات Classroom API أو تضمين زرَّي المشاركة مع Classroom |
| أريد أن يتمكّن معلمو Classroom من مزامنة أو استيراد المعلومات من "نظام معلومات الطالب". | يمكنك تنفيذ OneRoster لنظام معلومات الطالب أو إنشاء الموارد والوصول إليها باستخدام Classroom API. |
الخطوات الأولى
ننصح المطوّرين الجدد باتّباع الخطوات التالية قبل بدء مشروع جديد:
- اطّلِع على دليلنا حول بنية Classroom API.
- اطّلِع على مزيد من المعلومات عن الدرجات وأنواع المستخدمين وأهلية المستخدمين والإجراءات التي يتّخذها المشرفون. تشرح هذه الأدلة المفاهيم الفريدة في Google Classroom و Classroom API.
- فهم آلية عمل طلبات Classroom API
لبدء عملية التطوير، تأكَّد من إكمال الخطوات الأساسية. اختَر نطاقات Classroom API المناسبة لاحتياجاتك، ثمّ أعد إعداد البيئة وابدأ بتقديم الطلبات باتّباع أحد أدلة البدء السريع:
تجربة "مستكشف Google APIs"
لتجربة طرق الاستدعاء على البيانات المنشورة، جرِّب استخدام محرّك استكشاف Google APIs. لست بحاجة إلى كتابة أي رمز لبدء الاستخدام، ولكن عليك العِلم أنّه يمكن أن تؤدي الإجراءات التي تُجريها باستخدام "مستكشف واجهات برمجة التطبيقات" إلى تعديل البيانات الحالية.
من بين طرق بدء استدعاء الطرق هي استدعاء الطريقة courses.list(). لا تتطلّب هذه الطريقة أي مَعلمات طلب، ويمكنك استرداد id من قائمة الدورات التدريبية المعروضة لاستخدامها كمَعلمة طلب لطلبات واجهة برمجة التطبيقات الأخرى. إذا لم يكن لديك أي دورات تدريبية، يمكنك إنشاء دورة باستخدام الطريقة
courses.create().
يمكنك أيضًا الاطّلاع على مرجع Classroom API.