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 از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
courseId

string

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

studentGroupId

string

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

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

پارامترها
previewVersion

enum ( PreviewVersion )

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

درخواست بدنه

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

بدنه پاسخ

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

دامنه‌های مجوز

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

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

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