Method: courses.courseWork.studentSubmissions.list

Menampilkan daftar kiriman siswa yang diizinkan untuk dilihat oleh pemohon, dengan mempertimbangkan cakupan OAuth permintaan. Tanda hubung (-) dapat ditentukan sebagai courseWorkId untuk menyertakan kiriman siswa untuk beberapa item tugas kelas.

Siswa kursus hanya dapat melihat tugas mereka sendiri. Pengajar mata pelajaran dan administrator domain dapat melihat semua tugas yang dikirimkan siswa.

Metode ini menampilkan kode error berikut:

  • PERMISSION_DENIED jika pengguna yang meminta tidak diizinkan untuk mengakses kursus atau tugas kursus yang diminta, atau untuk error akses.
  • INVALID_ARGUMENT jika format permintaan salah.
  • NOT_FOUND jika kursus yang diminta tidak ada.

Permintaan HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
courseId

string

ID kursus. ID ini dapat berupa ID yang ditetapkan Classroom atau alias.
courseWorkId

string

ID tugas siswa yang akan diminta. Nilai ini dapat ditetapkan ke literal string "-" untuk meminta tugas siswa untuk semua tugas kursus dalam kursus yang ditentukan.

Parameter kueri

Parameter
userId

string

Argumen opsional untuk membatasi tugas siswa yang dikembalikan hanya pada tugas yang dimiliki oleh siswa dengan ID yang ditentukan. ID dapat berupa salah satu dari berikut:

  • ID numerik untuk pengguna
  • alamat email pengguna
  • literal string "me", yang menunjukkan pengguna yang meminta
states[]

enum (SubmissionState)

Status pengiriman yang diminta. Jika ditentukan, tugas siswa yang ditampilkan cocok dengan salah satu status tugas yang ditentukan.
late

enum (LateValues)

Nilai keterlambatan yang diminta. Jika ditentukan, kiriman siswa yang dikembalikan dibatasi oleh nilai yang diminta. Jika tidak ditentukan, kiriman akan ditampilkan terlepas dari nilai late.
pageSize

integer

Jumlah maksimum item yang akan ditampilkan. Nol atau tidak ditentukan menunjukkan bahwa server dapat menetapkan maksimum.

Server dapat menampilkan lebih sedikit hasil daripada jumlah yang ditentukan.
pageToken

string

Nilai nextPageToken yang ditampilkan dari panggilan list sebelumnya, yang menunjukkan bahwa halaman hasil berikutnya harus ditampilkan.

Permintaan list harus identik dengan permintaan yang menghasilkan token ini.
previewVersion

enum (PreviewVersion)

Opsional. Versi pratinjau API. Setelan ini harus ditetapkan untuk mengakses kemampuan API baru yang tersedia bagi developer dalam Program Pratinjau.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons saat mencantumkan kiriman siswa.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "studentSubmissions": [
    {
      object (StudentSubmission)
    }
  ],
  "nextPageToken": string
}
Kolom
studentSubmissions[]

object (StudentSubmission)

Tugas siswa yang sesuai dengan permintaan.
nextPageToken

string

Token yang mengidentifikasi halaman hasil berikutnya yang akan ditampilkan. Jika kosong, tidak ada hasil lainnya yang tersedia.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/classroom.coursework.students.readonly
  • https://www.googleapis.com/auth/classroom.coursework.me.readonly
  • https://www.googleapis.com/auth/classroom.coursework.students
  • https://www.googleapis.com/auth/classroom.coursework.me

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

LateValues

Batasan pada nilai keterlambatan item yang dikembalikan.

Enum
LATE_VALUES_UNSPECIFIED Tidak ada batasan pada nilai keterlambatan pengiriman yang ditentukan.
LATE_ONLY Mengembalikan StudentSubmissions yang terlambatnya bernilai benar (true).
NOT_LATE_ONLY Mengembalikan StudentSubmissions yang terlambatnya salah (false).