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