Method: courses.studentGroups.create

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

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

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

درخواست HTTP

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

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

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

پارامترها
courseId

string

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

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

پارامترها
previewVersion

enum ( PreviewVersion )

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

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

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

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

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