در حالی که هر برنامه‌نویسی می‌تواند برای 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 از شناسه مشتری OAuth که برای ارسال درخواست استفاده می‌شود، ایجاد یا تغییر دهد . | CREATE_ADD_ON_ATTACHMENT |
| می تواند تنظیمات دوره درجه بندی را تغییر دهد | UPDATE_GRADING_PERIOD_SETTINGS |
| می تواند یک روبریک ایجاد ، اصلاح یا حذف کند | CREATE_RUBRIC |
بعد، فیلد allowed در پاسخ را بررسی کنید. اگر allowed true باشد، کاربر به Capability انتخابی دسترسی دارد. سپس می توانید درخواست های API مربوط به Capability از طرف کاربر انجام دهید.