Method: courses.students.create

Menambahkan pengguna sebagai siswa kursus.

Administrator domain diizinkan untuk menambahkan pengguna dalam domain mereka sebagai siswa ke kursus dalam domain mereka secara langsung. Siswa diizinkan untuk menambahkan diri ke kursus menggunakan kode pendaftaran.

Metode ini menampilkan kode error berikut:

  • PERMISSION_DENIED jika pengguna yang meminta tidak diizinkan untuk membuat siswa di kursus ini atau karena error akses.
  • NOT_FOUND jika ID kursus yang diminta tidak ada.
  • FAILED_PRECONDITION jika akun pengguna yang diminta dinonaktifkan, untuk error permintaan berikut:
    • CourseMemberLimitReached
    • CourseNotModifiable
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • ALREADY_EXISTS jika pengguna sudah menjadi siswa atau pengajar dalam kursus.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
courseId

string

ID kursus tempat siswa dibuat. ID ini dapat berupa ID yang ditetapkan Classroom atau alias.

Parameter kueri

Parameter
enrollmentCode

string

Kode pendaftaran kursus tempat siswa akan dibuat. Kode ini diperlukan jika userId sesuai dengan pengguna yang meminta; kode ini dapat dihilangkan jika pengguna yang meminta memiliki izin administratif untuk membuat siswa bagi pengguna mana pun.

Isi permintaan

Isi permintaan memuat instance Student.

Isi respons

Jika berhasil, isi respons memuat instance Student yang baru dibuat.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.