REST Resource: courses.courseWork.studentSubmissions

Resource: StudentSubmission

Pengiriman tugas siswa untuk tugas kelas.

Item StudentSubmission dibuat saat item CourseWork dibuat.

Tugas siswa yang belum pernah diakses (yaitu dengan state = NEW) mungkin tidak memiliki waktu pembuatan atau waktu pembaruan.

Representasi JSON 
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "userId": string,
  "creationTime": string,
  "updateTime": string,
  "state": enum (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "rubricId": string,
  "draftRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "assignedRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
}
Kolom
courseId

string

ID kursus.

Hanya baca.
courseWorkId

string

ID untuk tugas kursus yang sesuai.

Hanya baca.
id

string

ID yang ditetapkan Classroom untuk pengiriman tugas siswa. ID ini bersifat unik di antara tugas yang dikirim untuk tugas kursus yang relevan.

Hanya baca.
userId

string

ID untuk siswa yang memiliki pengiriman ini.

Hanya baca.
creationTime

string (Timestamp format)

Waktu pembuatan pengiriman ini. Kolom ini mungkin tidak ditetapkan jika siswa belum mengakses item ini.

Hanya baca.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Waktu pembaruan terakhir pengiriman ini. Kolom ini mungkin tidak ditetapkan jika siswa belum mengakses item ini.

Hanya baca.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
state

enum (SubmissionState)

Status pengiriman ini.

Hanya baca.
late

boolean

Apakah pengiriman tugas ini terlambat.

Hanya baca.
draftGrade

number

Nilai tertunda opsional. Jika tidak disetel, tidak ada nilai yang ditetapkan. Nilai ini tidak boleh negatif. Nilai desimal (yaitu, non-bilangan bulat) diizinkan, tetapi dibulatkan menjadi dua angka desimal.

Bagian ini hanya dapat dilihat dan diubah oleh pengajar kursus.
assignedGrade

number

Nilai opsional. Jika tidak disetel, tidak ada nilai yang ditetapkan. Nilai ini tidak boleh negatif. Nilai desimal (yaitu, non-bilangan bulat) diizinkan, tetapi dibulatkan menjadi dua angka desimal.

Ini hanya dapat diubah oleh pengajar kursus.
rubricId

string

Hanya output. ID rubrik yang saat ini dilampirkan ke tugas kelas ini dan digunakan untuk menilai pengiriman siswa ini.

ID ini kosong jika tidak ada rubrik. ID ini mencerminkan rubrik yang saat ini aktif; ID ini akan berubah jika pengajar menghapus dan membuat ulang rubrik.

Hanya baca.

draftRubricGrades

map (key: string, value: object (RubricGrade))

Nilai rubrik yang tertunda berdasarkan kriteria rubrik.

Peta ini kosong jika tidak ada rubrik yang dilampirkan ke tugas kelas ini atau jika rubrik dilampirkan, tetapi tidak ada nilai yang ditetapkan pada kriteria apa pun. Entri hanya diisi untuk nilai yang telah ditetapkan. Kunci: ID kriteria rubrik.

Hanya baca.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignedRubricGrades

map (key: string, value: object (RubricGrade))

Nilai rubrik yang ditetapkan berdasarkan Kriteria rubrik.

Peta ini kosong jika tidak ada rubrik yang dilampirkan ke tugas kelas ini atau jika rubrik dilampirkan, tetapi tidak ada nilai yang ditetapkan pada Kriteria apa pun. Entri hanya diisi untuk nilai yang telah ditetapkan. Kunci: ID kriteria rubrik.

Hanya baca.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
courseWorkType

enum (CourseWorkType)

Jenis tugas kursus yang terkait dengan pengiriman ini.

Hanya baca.
associatedWithDeveloper

boolean

Apakah tugas siswa ini terkait dengan project Konsol Developer yang membuat permintaan.

Lihat courseWork.create untuk mengetahui detail selengkapnya.

Hanya baca.
submissionHistory[]

object (SubmissionHistory)

Histori tugas (termasuk histori status dan nilai).

Hanya baca.
previewVersion

enum (PreviewVersion)

Hanya output. Versi pratinjau API. Hal ini harus ditetapkan untuk mengakses kemampuan API baru yang tersedia bagi developer dalam Program Pratinjau.
Konten pengiriman. Jenis spesifiknya bergantung pada nilai course_work_type. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
assignmentSubmission

object (AssignmentSubmission)

Konten tugas saat courseWorkType adalah ASSIGNMENT.

Siswa dapat mengubah konten ini menggunakan studentSubmissions.modifyAttachments.
shortAnswerSubmission

object (ShortAnswerSubmission)

Konten tugas jika courseWorkType adalah SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Konten tugas jika courseWorkType adalah MULTIPLE_CHOICE_QUESTION.
Akhir kolom yang saling eksklusif.

RubricGrade

Nilai rubrik yang ditetapkan untuk tugas yang dikirimkan siswa. Maksimal ada satu entri per kriteria rubrik.

Representasi JSON 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
Kolom
criterionId

string

Opsional. ID kriteria.
levelId

string

Opsional. ID level opsional dari level yang dipilih. Jika kosong, berarti tidak ada level yang dipilih.
points

number

Opsional. Poin opsional yang ditetapkan untuk kriteria ini, biasanya berdasarkan level. Level mungkin memiliki poin atau tidak. Jika tidak disetel, tidak ada poin yang ditetapkan untuk kriteria ini.

AssignmentSubmission

Tugas siswa untuk suatu tugas.

Representasi JSON 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
Kolom
attachments[]

object (Attachment)

Lampiran yang ditambahkan oleh siswa. File Drive yang sesuai dengan materi dengan mode berbagi STUDENT_COPY mungkin belum ada jika siswa belum mengakses tugas di Classroom.

Beberapa metadata lampiran hanya diisi jika pengguna yang meminta memiliki izin untuk mengaksesnya. Kolom identifier dan alternateLink selalu tersedia, tetapi kolom lainnya (misalnya, title) mungkin tidak tersedia.

Lampiran

Lampiran ditambahkan ke tugas siswa.

Saat membuat lampiran, penetapan kolom form tidak didukung.

Representasi JSON 
{

  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
}
Kolom
Data lampiran. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
driveFile

object (DriveFile)

Lampiran file Google Drive.
youTubeVideo

object (YouTubeVideo)

Lampiran video YouTube.
form

object (Form)

Lampiran Google Formulir.
Akhir kolom yang saling eksklusif.

ShortAnswerSubmission

Tugas siswa untuk pertanyaan jawaban singkat.

Representasi JSON 
{
  "answer": string
}
Kolom
answer

string

Respons siswa terhadap pertanyaan jawaban singkat.

MultipleChoiceSubmission

Tugas siswa untuk pertanyaan pilihan ganda.

Representasi JSON 
{
  "answer": string
}
Kolom
answer

string

Pilihan siswa.

SubmissionHistory

Histori pengiriman. Saat ini, data ini mencakup histori status dan nilai.

Representasi JSON 
{

  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
}
Kolom
Jenis SubmissionHistory, dapat berupa salah satu dari StateHistory, GradeHistory. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
stateHistory

object (StateHistory)

Informasi histori status pengiriman, jika ada.
gradeHistory

object (GradeHistory)

Informasi histori nilai tugas, jika ada.
Akhir kolom yang saling eksklusif.

StateHistory

Histori setiap status yang pernah dialami pengiriman ini.

Representasi JSON 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
Kolom
state

enum (State)

Tahap pipeline alur kerja.
stateTimestamp

string (Timestamp format)

Waktu pengiriman memasuki status ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
actorUserId

string

Pengajar atau siswa yang melakukan perubahan.

Negara Bagian

Kemungkinan status pengiriman.

Enum
STATE_UNSPECIFIED Status tidak ditentukan. Hal ini tidak boleh ditampilkan.
CREATED Pengiriman telah dibuat.
TURNED_IN Siswa telah menyerahkan dokumen yang ditugaskan, yang mungkin berupa template atau bukan.
RETURNED Pengajar telah mengembalikan dokumen yang ditugaskan kepada siswa.
RECLAIMED_BY_STUDENT Siswa menyerahkan dokumen yang ditugaskan, lalu memilih untuk "membatalkan pengiriman" tugas, sehingga siswa kembali memiliki kontrol sebagai pemilik.
STUDENT_EDITED_AFTER_TURN_IN Siswa mengedit tugasnya setelah menyerahkannya. Saat ini, hanya digunakan oleh Pertanyaan, saat siswa mengedit jawaban mereka.

GradeHistory

Histori setiap nilai pada tugas ini.

Representasi JSON 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
Kolom
pointsEarned

number

Pembilang nilai saat ini dalam histori nilai pengiriman.
maxPoints

number

Penyebut nilai pada saat ini dalam histori nilai pengiriman.
gradeTimestamp

string (Timestamp format)

Waktu saat nilai tugas diubah.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
actorUserId

string

Pengajar yang melakukan perubahan nilai.
gradeChangeType

enum (GradeChangeType)

Jenis perubahan nilai saat ini dalam histori nilai tugas.

GradeChangeType

Kemungkinan jenis perubahan nilai.

Enum
UNKNOWN_GRADE_CHANGE_TYPE Tidak ada jenis perubahan nilai yang ditentukan. Hal ini tidak boleh ditampilkan.
DRAFT_GRADE_POINTS_EARNED_CHANGE Perubahan pada pembilang nilai draf.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Perubahan pada pembilang nilai yang ditetapkan.
MAX_POINTS_CHANGE Perubahan pada penyebut nilai.

Metode

get

 Menampilkan tugas siswa.

list

 Menampilkan daftar tugas siswa yang diizinkan untuk dilihat oleh pemohon, dengan mempertimbangkan cakupan OAuth permintaan.

modifyAttachments

 Mengubah lampiran tugas yang dikirim siswa.

patch

 Memperbarui satu atau beberapa kolom tugas siswa.

reclaim

 Mengklaim kembali tugas siswa atas nama siswa yang memilikinya.

return

 Menampilkan tugas siswa.

turnIn

 Menyerahkan kiriman siswa.