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

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

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

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

  • ایجاد پیوست‌های افزودنی Classroom
  • تغییر تنظیمات دوره درجه بندی

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

درخواست‌ها به 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 از طرف کاربر انجام دهید.