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