لا يمكن للمستخدم الذي يطلب الميزة التحقّق من الإمكانات إلا لنفسه.
تُرجع هذه الطريقة رموز الأخطاء التالية:
PERMISSION_DENIED
إذا لم يكن مسموحًا للمستخدم المُقدّم للطلب التحقّق من أهلية المستخدم المحدّد.INVALID_ARGUMENT
إذا كان الطلب غير صالح
طلب HTTP
GET https://classroom.googleapis.com/v1/userProfiles/{userId}:checkUserCapability
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
userId |
مطلوب. معرّف المستخدم عند تحديده كمَعلمة لطلب، يمكن أن يكون هذا المعرّف أحد العناصر التالية:
|
مَعلمات طلب البحث
المعلمات | |
---|---|
capability |
مطلوب. الميزة التي يجب التحقّق منها لهذا المستخدم. على سبيل المثال، للتحقّق مما إذا كان بإمكان المستخدم إنشاء مرفق إضافة، اضبط هذا الخيار على |
previewVersion |
اختياريّ. إصدار المعاينة لواجهة برمجة التطبيقات. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
ردّ من التحقّق من إمكانات المستخدم
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"capability": enum ( |
الحقول | |
---|---|
capability |
إمكانيات Classroom |
allowed |
ما إذا كان يُسمح للمستخدم بالاستفادة من الميزة المحدّدة |
نطاقات التفويض
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/classroom.courses
https://www.googleapis.com/auth/classroom.courses.readonly
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
الإمكانية
التعداد لتمثيل الإمكانية.
عمليات التعداد | |
---|---|
CAPABILITY_UNSPECIFIED |
غير مدعوم. |
CREATE_ADD_ON_ATTACHMENT |
إمكانية إنشاء وتعديل AddOnAttachments المرتبطة بمشروع Developer Console الخاص بمعرّف عميل OAuth المستخدَم لتقديم الطلب |
UPDATE_GRADING_PERIOD_SETTINGS |
إمكانية تعديل إعدادات فترة التقييم |