أهلية المستخدم

على الرغم من أنّه يمكن لأي مطوّر إرسال طلبات إلى Google Classroom API، لا تتوفّر بعض ميزات Google Classroom إلا لمستخدمين معيّنين. يمكن أن تفرض كل ميزة متطلبات مختلفة، مثل توفُّر نوع معيّن من ترخيص Google Workspace for Education. للاطّلاع على تفاصيل مفصّلة عن الميزات في كل مستوى من مستويات ترخيص Google Workspace for Education، يُرجى الاطّلاع على صفحة مقارنة الإصدارات.

مصطلح رئيسي: يمتلك المستخدم المؤهَّل القدرة على استخدام ميزة معيّنة في Google Classroom إذا كان يستوفي متطلباتها.

النقطة الرئيسية: يتم تحديد الإمكانية بشكل منفصل لكل مستخدم ويمكن أن تتغيّر بمرور الوقت. قد تختلف متطلبات الأهلية لاستخدام بعض ميزات Classroom API عن المتطلبات الخاصة بالميزات المقابلة لها في تطبيق Google Classroom. على سبيل المثال، تنطبق متطلبات ترخيص معيّنة عند إنشاء قوائم التقييم أو تعديلها أو حذفها باستخدام واجهة برمجة التطبيقات.

الميزات التي تفرض متطلبات أهلية

لا تتوفّر ميزات Classroom API التالية إلا للمستخدمين المؤهَّلين:

• إنشاء وتعديل مرفقات إضافة Classroom
• تعديل إعدادات فترة وضع الدرجات
• إنشاء المخطّطات النموذجية وتعديلها وحذفها

تحديد إمكانات المستخدم

يتم إرسال الطلبات إلى Classroom API بالنيابة عن مستخدمين فرديين. لذلك، عليك التحقّق مما إذا كان لدى المستخدم الإمكانات المناسبة قبل إصدار طلبات واجهة برمجة التطبيقات التي تستوفي متطلبات الأهلية.

النقطة الرئيسية: ننصحك بالتحقّق من إمكانات المستخدمين بشكل استباقي حتى تتمكّن من تخصيص مظهر منتجك أو سلوكه ليتوافق مع ميزات Classroom التي يمكنهم الوصول إليها.

لتحديد ما إذا كان لدى المستخدم قدرة معيّنة، قدِّم طلبًا إلى واجهة برمجة التطبيقات لتطبيق الأسلوب checkUserCapability. أدرِج نوع Capability المناسب لميزة Classroom التي تريد استخدامها. حدِّدCapability المناسب لكل ميزة:

لمعرفة ما إذا كان المستخدم...	Capability
يمكنه إنشاء أو تعديل مرفق إضافة Classroom المرتبط بمشروع Google Cloud الخاص بمعرّف عميل OAuth المستخدَم لتقديم الطلب.	CREATE_ADD_ON_ATTACHMENT
يمكنه تعديل إعدادات فترة وضع الدرجات	UPDATE_GRADING_PERIOD_SETTINGS
يمكنه إنشاء قاعدة تقييم أو تعديلها أو حذفها	CREATE_RUBRIC

بعد ذلك، ضَع علامة في حقل allowed في الردّ. إذا كان allowed هو true، يمكن للمستخدم الوصول إلى Capability المحدّدة. يمكنك بعد ذلك تقديم طلبات واجهة برمجة التطبيقات المرتبطة بـ Capability نيابةً عن المستخدم.

ملاحظة مهمة: حتى إذا كان المستخدم مؤهلاً، يبقى من الممكن أن تُرفَض طلبات واجهة برمجة التطبيقات التي تعتمد على الأهلية. يشير مدى الأهلية إلى أنّه يمكن للمستخدم استخدام إحدى ميزات Classroom، وليس إلى أنّه سيتم تنفيذ طلب معيّن بنجاح.