افزونه های Google Classroom اکنون به طور کلی در دسترس توسعه دهندگان هستند! لطفاً برای اطلاعات بیشتر به
اسناد افزونه ها مراجعه کنید.
Method: courses.checkAddOnCreationEligibility
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
نشان می دهد که آیا کاربر واجد شرایط ایجاد پیوست های افزودنی در یک دوره خاص است یا خیر.
این روش منسوخ شده است. به جای آن از UserProfiles.checkUserCapability
استفاده کنید.
این روش کدهای خطای زیر را برمی گرداند:
- اگر کاربر درخواست کننده اجازه دسترسی به دوره درخواستی یا خطاهای دسترسی را نداشته باشد،
PERMISSION_DENIED
. - اگر درخواست نادرست باشد
INVALID_ARGUMENT
. - اگر دوره درخواستی وجود نداشته باشد،
NOT_FOUND
.
درخواست HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}:checkAddOnCreationEligibility
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
courseId | string مورد نیاز. شناسه دوره |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
اینکه آیا یک کاربر معلم مجاز به ایجاد پیوستهای افزودنی برای یک دوره خاص است یا خیر.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"courseId": string,
"isCreateAttachmentEligible": boolean
} |
فیلدها |
---|
courseId | string تغییرناپذیر. شناسه دوره |
isCreateAttachmentEligible | boolean اینکه آیا معلم مجاز به ایجاد پیوست های افزودنی در این دوره است یا خیر. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/classroom.addons.teacher
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: courses.checkAddOnCreationEligibility\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.CheckAddOnCreationEligibilityResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\n| This item is deprecated!\nReturns whether a user is eligible to create add-on attachments in a given course.\n\nThis method is deprecated. Use [`UserProfiles.checkUserCapability`](/workspace/classroom/reference/rest/v1/userProfiles/checkUserCapability#body.PATH_PARAMETERS.user_id) instead.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course or for [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if the requested course does not exist.\n\n### HTTP request\n\n`GET https://classroom.googleapis.com/v1/courses/{courseId}:checkAddOnCreationEligibility`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|----------------------------------------------|\n| `courseId` | `string` Required. Identifier of the course. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nWhether a teacher user is allowed to create add-on attachments for a given course.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------|\n| ``` { \"courseId\": string, \"isCreateAttachmentEligible\": boolean } ``` |\n\n| Fields ||\n|------------------------------|---------------------------------------------------------------------------------------|\n| `courseId` | `string` Immutable. Identifier of the course. |\n| `isCreateAttachmentEligible` | `boolean` Whether the teacher is allowed to create add-on attachments in this course. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.addons.teacher`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]