REST Resource: courses.courseWork.studentSubmissions

Resource: StudentSubmission

Kiriman siswa untuk tugas kursus.

Item StudentSubmission dibuat saat item CourseWork dibuat.

Kiriman siswa yang belum pernah diakses (yaitu dengan state = BARU) mungkin tidak memiliki waktu pembuatan atau waktu update.

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),

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
Kolom
courseId

string

ID kursus.

Hanya baca.
courseWorkId

string

ID untuk tugas kursus yang sesuai dengan tugas ini.

Hanya baca.
id

string

ID yang ditetapkan Classroom untuk kiriman tugas siswa. Nilai ini unik di antara kiriman untuk tugas kursus yang relevan.

Hanya baca.
userId

string

ID untuk siswa yang memiliki kiriman ini.

Hanya baca.
creationTime

string (Timestamp format)

Waktu pembuatan kiriman ini. Nilai ini mungkin tidak disetel jika siswa belum mengakses item ini.

Hanya baca.

Menggunakan RFC 3339, dengan output yang dihasilkan 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 update terakhir kiriman ini. Nilai ini mungkin tidak disetel jika siswa belum mengakses item ini.

Hanya baca.

Menggunakan RFC 3339, dengan output yang dihasilkan 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 kiriman 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 tempat 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 tempat desimal.

Ini hanya dapat diubah oleh pengajar kursus.
rubricId

string

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

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

Hanya baca.

draftRubricGrades

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

Nilai rubrik tertunda berdasarkan kriteria rubrik.

Peta ini kosong jika tidak ada rubrik yang dilampirkan pada 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 mata pelajaran yang terkait dengan kiriman ini.

Hanya baca.
associatedWithDeveloper

boolean

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

Lihat courseWork.create untuk mengetahui detail selengkapnya.

Hanya baca.
submissionHistory[]

object (SubmissionHistory)

Histori pengiriman (mencakup histori status dan nilai).

Hanya baca.
previewVersion

enum (PreviewVersion)

Hanya output. Versi pratinjau API. Setelan ini harus ditetapkan untuk mengakses kemampuan API baru yang tersedia bagi developer dalam Program Pratinjau.
Kolom union content. Konten kiriman. Jenis spesifik bergantung pada nilai course_work_type. content hanya dapat berupa salah satu dari hal berikut:
assignmentSubmission

object (AssignmentSubmission)

Konten pengiriman saat courseWorkType adalah ASSIGNMENT.

Siswa dapat mengubah konten ini menggunakan studentSubmissions.modifyAttachments.
shortAnswerSubmission

object (ShortAnswerSubmission)

Konten kiriman saat courseWorkType adalah SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Konten pengiriman saat courseWorkType adalah MULTIPLE_CHOICE_QUESTION.

RubricGrade

Kumpulan nilai rubrik yang ditetapkan untuk kiriman 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 tingkat opsional dari tingkat yang dipilih. Jika kosong, tidak ada level yang dipilih.
points

number

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

AssignmentSubmission

Tugas siswa untuk 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 ID dan alternateLink selalu tersedia, tetapi kolom lainnya (misalnya, judul) mungkin tidak tersedia.

Lampiran

Lampiran ditambahkan ke tugas siswa.

Saat membuat lampiran, setelan kolom form tidak didukung.

Representasi JSON 
{

  // Union field attachment can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field attachment.
}
Kolom
Kolom union attachment. Data lampiran. attachment hanya dapat berupa salah satu dari berikut:
driveFile

object (DriveFile)

Lampiran file Google Drive.
youTubeVideo

object (YouTubeVideo)

Lampiran video YouTube.
form

object (Form)

Lampiran Google Formulir.

ShortAnswerSubmission

Tugas siswa untuk pertanyaan jawaban singkat.

Representasi JSON 
{
  "answer": string
}
Kolom
answer

string

Jawaban siswa untuk pertanyaan jawaban singkat.

MultipleChoiceSubmission

Tugas siswa untuk pertanyaan pilihan ganda.

Representasi JSON 
{
  "answer": string
}
Kolom
answer

string

Pilihan yang dipilih siswa.

SubmissionHistory

Histori pengiriman. Saat ini, hal ini mencakup histori negara bagian dan kelas.

Representasi JSON 
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
Kolom
Kolom union type. Jenis SubmissionHistory, dapat berupa StateHistory, GradeHistory. type hanya dapat berupa salah satu dari berikut:
stateHistory

object (StateHistory)

Informasi histori status pengiriman, jika ada.
gradeHistory

object (GradeHistory)

Informasi histori nilai kiriman, jika ada.

StateHistory

Histori setiap status yang pernah dimiliki kiriman ini.

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

enum (State)

Tahap pipeline alur kerja.
stateTimestamp

string (Timestamp format)

Saat pengiriman memasuki status ini.

Menggunakan RFC 3339, dengan output yang dihasilkan 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 Negara bagian tidak ditentukan. Hal ini tidak boleh ditampilkan.
CREATED Kiriman telah dibuat.
TURNED_IN Siswa telah menyerahkan dokumen yang ditetapkan, yang mungkin atau mungkin tidak berupa template.
RETURNED Pengajar telah mengembalikan dokumen yang ditetapkan kepada siswa.
RECLAIMED_BY_STUDENT Siswa menyerahkan dokumen yang ditetapkan, lalu memilih untuk "membatalkan pengiriman" tugas, sehingga siswa kembali memiliki kontrol sebagai pemilik.
STUDENT_EDITED_AFTER_TURN_IN Siswa mengedit kiriman mereka setelah menyerahkannya. Saat ini, hanya digunakan oleh Pertanyaan, saat siswa mengedit jawabannya.

GradeHistory

Histori setiap nilai pada kiriman ini.

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

number

Pembilang nilai pada saat ini dalam histori nilai pengiriman.
maxPoints

number

Penyebut nilai pada saat ini dalam histori nilai pengiriman.
gradeTimestamp

string (Timestamp format)

Saat nilai kiriman diubah.

Menggunakan RFC 3339, dengan output yang dihasilkan 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 pada saat ini dalam histori nilai pengiriman.

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 kiriman siswa.

list

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

modifyAttachments

 Mengubah lampiran kiriman siswa.

patch

 Memperbarui satu atau beberapa kolom kiriman siswa.

reclaim

 Mengklaim ulang kiriman siswa atas nama siswa yang memilikinya.

return

 Menampilkan kiriman siswa.

turnIn

 Menyerahkan kiriman siswa.