واجد شرایط بودن کاربر

در حالی که هر برنامه‌نویسی می‌تواند برای Google Classroom API درخواست کند، برخی از ویژگی‌های Google Classroom فقط برای کاربران خاصی در دسترس هستند. هر ویژگی می‌تواند الزامات مختلفی داشته باشد، مانند داشتن یک نوع مجوز Google Workspace for Education. برای تفکیک دقیق ویژگی‌ها در هر سطح مجوز Google Workspace for Education، صفحه مقایسه نسخه‌ها را ببینید.

اصطلاح کلیدی: یک کاربر واجد شرایط می‌تواند از یک ویژگی خاص Classroom در صورتی که شرایط مورد نیاز ویژگی را برآورده کند، استفاده کند.

نکته کلیدی: قابلیت به طور جداگانه برای هر کاربر تعیین می شود و می تواند در طول زمان تغییر کند. واجد شرایط بودن قابلیت برای برخی از ویژگی‌های Classroom API ممکن است با ویژگی‌های مربوطه در برنامه Google Classroom متفاوت باشد. به عنوان مثال، هنگام ایجاد، تغییر یا حذف روبریک ها با API، الزامات مجوز خاصی اعمال می شود.

ویژگی هایی با شرایط واجد شرایط بودن

ویژگی‌های Classroom API زیر فقط برای کاربران واجد شرایط در دسترس است:

• ایجاد و اصلاح پیوست‌های Classroom .
• تغییر تنظیمات دوره درجه بندی
• ایجاد، اصلاح و حذف روبریک ها .

قابلیت های کاربر را تعیین کنید

درخواست‌ها به Classroom API از طرف تک تک کاربران انجام می‌شود. بنابراین، قبل از صدور درخواست‌های API با الزامات واجد شرایط بودن، باید بررسی کنید که آیا یک کاربر دارای قابلیت‌های مناسب است یا خیر.

نکته کلیدی: بررسی فعالانه قابلیت‌های کاربر را در نظر بگیرید تا بتوانید ظاهر یا رفتار محصول خود را متناسب با ویژگی‌های Classroom که آنها می‌توانند به آن دسترسی داشته باشند، تنظیم کنید.

برای تعیین اینکه آیا یک کاربر قابلیت خاصی دارد یا خیر، یک درخواست 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 از طرف کاربر انجام دهید.

مهم: حتی زمانی که یک کاربر واجد شرایط باشد، باز هم ممکن است درخواست‌های API که به واجد شرایط بودن بستگی دارد با شکست مواجه شوند. واجد شرایط بودن به این معنی است که کاربر می تواند از ویژگی Classroom استفاده کند، نه اینکه یک درخواست خاص موفق شود.