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