Method: courses.students.create

Menambahkan pengguna sebagai siswa kursus.

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

Metode ini menampilkan kode error berikut:

  • PERMISSION_DENIED jika pengguna yang meminta tidak diizinkan untuk membuat siswa dalam kursus ini atau untuk 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 akan dibuat. ID ini dapat berupa ID yang diberikan 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 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.