Method: courses.students.create

کاربر را به عنوان دانشجوی یک دوره اضافه می کند.

مدیران دامنه مجازند مستقیماً کاربران درون دامنه خود را به عنوان دانشجو به دوره های درون دامنه خود اضافه کنند . دانش آموزان مجاز هستند با استفاده از کد ثبت نام خود را به یک دوره اضافه کنند.

این روش کدهای خطای زیر را برمی گرداند:

  • PERMISSION_DENIED اگر کاربر درخواست کننده مجاز به ایجاد دانش آموزان در این دوره یا برای خطاهای دسترسی نباشد.
  • اگر شناسه دوره درخواستی وجود نداشته باشد، NOT_FOUND .
  • FAILED_PRECONDITION اگر حساب کاربر درخواستی غیرفعال باشد، برای خطاهای درخواستی زیر:
    • CourseMemberLimitReached
    • CourseNotModifiable
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • ALREADY_EXISTS اگر کاربر قبلاً دانش‌آموز یا معلم دوره باشد.

درخواست HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/students

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
courseId

string

شناسه دوره برای ایجاد دانش آموز. این شناسه می تواند شناسه اختصاص داده شده توسط Classroom یا alias باشد.

پارامترهای پرس و جو

مولفه های
enrollmentCode

string

کد ثبت نام دوره برای ایجاد دانش آموز. در صورتی که userId با کاربر درخواست کننده مطابقت داشته باشد، این کد مورد نیاز است. اگر کاربر درخواست کننده دارای مجوزهای مدیریتی برای ایجاد دانش آموزان برای هر کاربر باشد، ممکن است حذف شود.

درخواست بدن

بدنه درخواست شامل نمونه ای از Student است.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از Student است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.