REST Resource: courses.courseWork.studentSubmissions

Resource: StudentSubmission

Pengiriman tugas siswa untuk kursus.

Item StudentSubmission dibuat saat item CourseWork dibuat.

Pengiriman siswa yang belum pernah diakses (yaitu dengan state = BARU) 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),

  // 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.

Hanya baca.
id

string

ID yang ditetapkan Classroom untuk kiriman siswa. 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 ditetapkan jika siswa belum mengakses item ini.

Hanya baca.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Waktu pembaruan terakhir kiriman ini. Nilai ini mungkin tidak ditetapkan jika siswa belum mengakses item ini.

Hanya baca.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
state

enum (SubmissionState)

Status pengiriman ini.

Hanya baca.
late

boolean

Apakah pengiriman ini terlambat.

Hanya baca.
draftGrade

number

Nilai tertunda opsional. Jika tidak ditetapkan, tidak ada nilai yang ditetapkan. Nilai ini tidak boleh negatif. Nilai desimal (yaitu, bukan bilangan bulat) diizinkan, tetapi dibulatkan ke dua tempat desimal.

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

number

Nilai opsional. Jika tidak ditetapkan, tidak ada nilai yang ditetapkan. Nilai ini tidak boleh negatif. Nilai desimal (yaitu, bukan bilangan bulat) diizinkan, tetapi dibulatkan ke dua tempat desimal.

Hal ini hanya dapat diubah oleh pengajar kursus.
rubricId

string

Hanya output. ID rubrik yang saat ini dilampirkan ke tugas kursus 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 akan 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 ke tugas kursus ini atau jika rubrik dilampirkan, tetapi tidak ada nilai yang ditetapkan untuk 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 disertakan ke tugas kursus ini atau jika rubrik disertakan, 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 menjadi tujuan pengiriman ini.

Hanya baca.
associatedWithDeveloper

boolean

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

Lihat courseWork.create untuk mengetahui detail selengkapnya.

Hanya baca.
submissionHistory[]

object (SubmissionHistory)

Histori pengiriman (termasuk histori status dan nilai).

Hanya baca.
previewVersion

enum (PreviewVersion)

Hanya output. Versi pratinjau API. Ini harus ditetapkan untuk mengakses kemampuan API baru yang tersedia bagi developer di 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 kiriman 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 kiriman jika courseWorkType adalah MULTIPLE_CHOICE_QUESTION.

RubricGrade

Nilai rubrik yang ditetapkan untuk kiriman siswa. Maksimal 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 tingkat yang dipilih.
points

number

Opsional. Poin opsional yang ditetapkan untuk kriteria ini, biasanya berdasarkan tingkatnya. Level mungkin memiliki atau tidak memiliki titik. Jika tidak ditetapkan, 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.

Lampiran

Lampiran ditambahkan ke tugas siswa.

Saat membuat lampiran, penetapan 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

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, histori ini mencakup status dan histori nilai.

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 salah satu dari StateHistory, GradeHistory. type hanya dapat berupa salah satu dari berikut:
stateHistory

object (StateHistory)

Informasi histori status kiriman, jika ada.
gradeHistory

object (GradeHistory)

Informasi histori nilai pengiriman, jika ada.

StateHistory

Histori setiap status yang telah dimiliki pengiriman ini.

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

enum (State)

Tahap pipeline alur kerja.
stateTimestamp

string (Timestamp format)

Saat kiriman memasuki status ini.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
actorUserId

string

Pengajar atau siswa yang melakukan perubahan.

Negara Bagian

Kemungkinan status untuk pengiriman.

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

GradeHistory

Histori setiap nilai pada pengiriman 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 saat ini dalam histori nilai pengiriman.
gradeTimestamp

string (Timestamp format)

Saat nilai pengiriman diubah.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
actorUserId

string

Pengajar yang melakukan perubahan nilai.
gradeChangeType

enum (GradeChangeType)

Jenis perubahan nilai saat ini di histori nilai pengiriman.

GradeChangeType

Kemungkinan jenis perubahan nilai.

Enum
UNKNOWN_GRADE_CHANGE_TYPE Tidak ada jenis perubahan nilai yang ditentukan. Nilai 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

 Mengambil kembali kiriman siswa atas nama siswa yang memilikinya.

return

 Menampilkan kiriman siswa.

turnIn

 Menyerahkan kiriman siswa.