Method: courses.studentGroups.create

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

این متد کدهای خطای زیر را برمی‌گرداند:

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
courseId

string

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

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

پارامترها
previewVersion

enum ( PreviewVersion )

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

درخواست بدنه

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

بدنه پاسخ

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

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

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

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

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