Method: courses.studentGroups.studentGroupMembers.create

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

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

  • PERMISSION_DENIED اگر کاربر درخواست کننده مجاز به ایجاد گروه دانشجویی یا عضو برای خطاهای دسترسی نباشد.
  • اگر گروه دانش آموزی وجود نداشته باشد یا کاربر به گروه دانش آموزی دسترسی نداشته باشد، NOT_FOUND .
  • اگر عضو گروه دانشجویی از قبل وجود داشته باشد، ALREADY_EXISTS .
  • FAILED_PRECONDITION در صورت تلاش برای افزودن عضوی به گروه دانش آموزی که به حد مجاز عضویت خود رسیده است.

درخواست HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers

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

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

پارامترها
courseId

string

مورد نیاز. شناسه دوره.

studentGroupId

string

مورد نیاز. شناسه گروه دانش آموزی

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

پارامترها
previewVersion

enum ( PreviewVersion )

اختیاری. نسخه پیش نمایش API. این باید برای دسترسی به قابلیت‌های API جدیدی که در برنامه پیش‌نمایش برای توسعه‌دهندگان در دسترس است، تنظیم شود.

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

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

  • https://www.googleapis.com/auth/classroom.rosters

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