على الرغم من أنّ أي مطوّر يمكنه إرسال طلبات إلى 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 نيابةً عن المستخدم.