توفّر 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.
- تعرَّف على طريقة عمل طلبات Classroom API.
لبدء عملية التطوير، تأكَّد من إكمال خطوات المتطلبات الأساسية. اختَر نطاقات Classroom API المناسبة لاحتياجاتك، ثم اضبط بيئتك وابدأ في تقديم الطلبات باتّباع أحد أدلة البدء السريع:
تجربة مستكشف Google APIs
لتجربة استدعاء الطرق على البيانات المنشورة، يمكنك استخدام Google APIs Explorer. لست بحاجة إلى كتابة أي رمز برمجي للبدء، ولكن يجب أن تعلم أنّ الإجراءات التي تنفّذها باستخدام مستكشف واجهات برمجة التطبيقات يمكن أن تعدّل البيانات الحالية.
إحدى طرق بدء استدعاء الطرق هي استدعاء الطريقة courses.list(). لا تتطلّب هذه الطريقة أي مَعلمات طلب، ويمكنك استرداد id من قائمة الدورات التدريبية المعروضة لاستخدامه كمَعلمة طلب في طلبات أخرى إلى واجهة برمجة التطبيقات. إذا لم يكن لديك أي دورات تدريبية، يمكنك إنشاء دورة تدريبية باستخدام الطريقة
courses.create().
يمكنك أيضًا استكشاف مرجع واجهة برمجة تطبيقات Classroom.