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

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