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