Method: courses.students.create

ユーザーをコースの生徒として追加します。

ドメイン管理者は、ドメイン内のユーザーを、ドメイン内のコースに生徒として直接追加できます。生徒は登録コードを使用して自分をコースに追加できます。

このメソッドは、次のエラーコードを返します。

  • PERMISSION_DENIED: リクエスト元のユーザーがこのコースで生徒を作成することを許可されていない場合、またはアクセスエラーのため。
  • NOT_FOUND: リクエストされたコース ID が存在しない場合。
  • 以下のリクエスト エラーのため、リクエストされたユーザーのアカウントが無効になっている場合は FAILED_PRECONDITION。
    • CourseMemberLimitReached
    • CourseNotModifiable
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • ALREADY_EXISTS: ユーザーがすでにコースの生徒または教師である場合は、

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
courseId

string

生徒を作成するコースの ID。この識別子は、Classroom で割り当てられた識別子または alias です。

クエリ パラメータ

パラメータ
enrollmentCode

string

受講生を作成するコースの登録コード。userId がリクエストしているユーザーに対応する場合、このコードは必須です。リクエストしているユーザーにいずれかのユーザーの生徒を作成する管理者権限がある場合は、省略できます。

リクエスト本文

リクエストの本文には Student のインスタンスが含まれています。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された Student のインスタンスが含まれます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

詳細については、承認ガイドをご覧ください。