در حالی که هر برنامه‌نویسی می‌تواند برای Google Classroom API درخواست کند، برخی از ویژگی‌های Google Classroom فقط برای کاربران خاصی در دسترس هستند. هر ویژگی می‌تواند الزامات مختلفی داشته باشد، مانند داشتن یک نوع مجوز Google Workspace for Education. برای تفکیک دقیق ویژگی‌ها در هر سطح مجوز Google Workspace for Education، صفحه مقایسه نسخه‌ها را ببینید.
ویژگی هایی با شرایط واجد شرایط بودن
ویژگی‌های Classroom API زیر فقط برای کاربران واجد شرایط در دسترس است:
- ایجاد پیوست‌های افزودنی Classroom
- تغییر تنظیمات دوره درجه بندی
- ایجاد ، به روز رسانی ، و حذف روبریک ها
قابلیت های کاربر را تعیین کنید
درخواست‌ها به Classroom API از طرف تک تک کاربران انجام می‌شود. بنابراین، قبل از صدور درخواست‌های API با الزامات واجد شرایط بودن، باید بررسی کنید که آیا یک کاربر دارای قابلیت‌های مناسب است یا خیر.
برای تعیین اینکه آیا یک کاربر قابلیت خاصی دارد یا خیر، یک درخواست API به روش checkUserCapability ارسال کنید. برای ویژگی Classroom که قصد استفاده از آن را دارید، نوع Capability مناسب را وارد کنید. Capability مناسب برای هر ویژگی را مشخص کنید:
| برای دیدن اینکه آیا کاربر ... | Capability |
|---|---|
| به افزونه Classroom متعلق به پروژه Google Cloud درخواست کننده دسترسی دارد | CREATE_ADD_ON_ATTACHMENT |
| می تواند تنظیمات دوره درجه بندی را تغییر دهد | UPDATE_GRADING_PERIOD_SETTINGS |
| می تواند یک روبریک ایجاد یا تغییر دهد | CREATE_RUBRIC |
بعد، فیلد allowed در پاسخ را بررسی کنید. اگر allowed true باشد، کاربر به Capability انتخابی دسترسی دارد. سپس می توانید درخواست های API مربوط به Capability از طرف کاربر انجام دهید.