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

詳しくは、承認ガイドをご覧ください。