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

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