مع أنّ بإمكان أي مطوّر إرسال طلبات إلى Google Classroom API، لا تتوفّر بعض ميزات Google Classroom إلا لمستخدمين معيّنين. قد تتطلّب كل ميزة متطلبات مختلفة، مثل الحصول على نوع ترخيص معيّن من Google Workspace for Education. للحصول على تفاصيل حول الميزات المتاحة في كل مستوى ترخيص من Google Workspace for Education، يُرجى الاطّلاع على صفحة مقارنة الإصدارات.
الميزات التي تتطلّب استيفاء شروط الأهلية
تتوفّر ميزات Classroom API التالية للمستخدمين المؤهّلين فقط:
- إنشاء مرفقات إضافات Classroom وتعديلها
- تعديل إعدادات فترة وضع الدرجات
- إنشاء قواعد التقييم وتعديلها وحذفها
تحديد إمكانات المستخدم
يتم إرسال الطلبات إلى Classroom API بالنيابة عن مستخدمين فرديين. لذلك، عليك التحقّق مما إذا كان المستخدم يملك الإمكانات المناسبة قبل إرسال طلبات إلى واجهة برمجة التطبيقات تتضمّن متطلبات الأهلية.
لتحديد ما إذا كان المستخدم يملك إذنًا معيّنًا، أرسِل طلبًا إلى واجهة برمجة التطبيقات باستخدام طريقة checkUserCapability. أدرِج نوع Capability المناسب لميزة Classroom التي تريد استخدامها. حدِّد Capability المناسب لكل ميزة:
| لمعرفة ما إذا كان المستخدم... | Capability |
|---|---|
| يمكن إنشاء أو تعديل مرفق إضافي في Classroom مرتبط بمشروع Google Cloud الذي يتضمّن معرّف عميل OAuth المستخدَم لتقديم الطلب | CREATE_ADD_ON_ATTACHMENT |
| إمكانية تعديل إعدادات فترة وضع الدرجات | UPDATE_GRADING_PERIOD_SETTINGS |
| يمكن إنشاء قواعد تقييم أو تعديلها أو حذفها | CREATE_RUBRIC |
بعد ذلك، تحقَّق من الحقل allowed في الردّ. إذا كانت قيمة allowed هي true،
سيتمكّن المستخدم من الوصول إلى Capability المحدّد. يمكنك بعد ذلك إرسال طلبات إلى واجهة برمجة التطبيقات
مرتبطة بـ Capability نيابةً عن المستخدم.