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