نشان می دهد که آیا کاربر ممکن است از قابلیت Classroom مشخص شده استفاده کند یا خیر. برای مثال، از این نقطه پایانی میتوان برای بررسی اینکه آیا کاربر ممکن است پیوستهای افزودنی ایجاد کند یا خیر، استفاده کرد.
کاربر درخواست کننده فقط می تواند قابلیت ها را برای خود بررسی کند.
این روش کدهای خطای زیر را برمی گرداند:
-
PERMISSION_DENIED
اگر کاربر درخواست کننده مجاز به بررسی صلاحیت برای کاربر مشخص شده نباشد. - اگر درخواست نادرست باشد
INVALID_ARGUMENT
.
درخواست HTTP
GET https://classroom.googleapis.com/v1/userProfiles/{userId}:checkUserCapability
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
user Id | مورد نیاز. شناسه کاربر. هنگامی که به عنوان پارامتر یک درخواست مشخص می شود، این شناسه می تواند یکی از موارد زیر باشد:
|
پارامترهای پرس و جو
پارامترها | |
---|---|
capability | مورد نیاز. قابلیتی که باید برای این کاربر بررسی شود. برای مثال، برای بررسی اینکه آیا کاربر میتواند یک پیوست افزودنی ایجاد کند یا خیر، آن را روی |
preview Version | اختیاری. نسخه پیش نمایش API. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخ از بررسی قابلیت های کاربر.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"capability": enum ( |
فیلدها | |
---|---|
capability | قابلیت کلاس درس |
allowed | آیا قابلیت مشخص شده برای کاربر مجاز است یا خیر. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/classroom.courses
-
https://www.googleapis.com/auth/classroom.courses.readonly
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
قابلیت
Enum برای نشان دادن قابلیت.
Enums | |
---|---|
CAPABILITY_UNSPECIFIED | پشتیبانی نمی شود. |
CREATE_ADD_ON_ATTACHMENT | قابلیت ایجاد و تغییر AddOnAttachments مرتبط با پروژه Developer Console از شناسه مشتری OAuth که برای درخواست استفاده می شود. |
CREATE_RUBRIC | قابلیت ایجاد و اصلاح Rubrics. |
UPDATE_GRADING_PERIOD_SETTINGS | قابلیت تغییر تنظیمات دوره درجه بندی. |