کاربر درخواست کننده فقط می تواند قابلیت ها را برای خود بررسی کند.
این روش کدهای خطای زیر را برمی گرداند:
-
PERMISSION_DENIED
اگر کاربر درخواست کننده مجاز به بررسی صلاحیت برای کاربر مشخص شده نباشد. - اگر درخواست نادرست باشد
INVALID_ARGUMENT
.
درخواست HTTP
GET https://classroom.googleapis.com/v1/userProfiles/{userId}:checkUserCapability
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
userId | مورد نیاز. شناسه کاربر. هنگامی که به عنوان پارامتر یک درخواست مشخص می شود، این شناسه می تواند یکی از موارد زیر باشد:
|
پارامترهای پرس و جو
پارامترها | |
---|---|
capability | مورد نیاز. قابلیتی که باید برای این کاربر بررسی شود. برای مثال، برای بررسی اینکه آیا کاربر میتواند یک پیوست افزودنی ایجاد کند یا خیر، آن را روی |
previewVersion | اختیاری. نسخه پیش نمایش 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 | قابلیت تغییر تنظیمات دوره درجه بندی. |