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