REST Resource: courses.courseWork.studentSubmissions

Referensi: StudentSubmission

Pengiriman tugas siswa untuk tugas kursus.

StudentSubmission item dibuat saat item CourseWork dibuat.

Kiriman 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 terkait dengan ini.

Hanya baca.

id

string

ID yang diberikan Classroom untuk kiriman siswa. Hal ini unik di antara kiriman untuk tugas materi yang relevan.

Hanya baca.

userId

string

ID untuk siswa yang memiliki kiriman ini.

Hanya baca.

creationTime

string (Timestamp format)

Waktu pembuatan kiriman ini. Opsi ini dapat dibatalkan penetapannya 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 pengiriman ini. Opsi ini dapat dibatalkan penetapannya 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 penyerahan tugas ini.

Hanya baca.

late

boolean

Apakah pengiriman 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, bukan bilangan bulat) diizinkan, tetapi dibulatkan menjadi dua angka desimal.

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, bukan 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 pada tugas kursus dan digunakan untuk menilai kiriman siswa ini.

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

Hanya baca.

draftRubricGrades

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

Menunggu nilai rubrik berdasarkan kriteria rubrik.

Peta ini kosong jika tidak ada rubrik yang dilampirkan pada tugas mata pelajaran 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))

Penetapan nilai rubrik berdasarkan Kriteria rubrik.

Peta ini kosong jika tidak ada rubrik yang dilampirkan pada tugas mata pelajaran 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" }.

courseWorkType

enum (CourseWorkType)

Jenis tugas kursus yang digunakan untuk kiriman ini.

Hanya baca.

associatedWithDeveloper

boolean

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

Lihat courseWork.create untuk mengetahui detail selengkapnya.

Hanya baca.

submissionHistory[]

object (SubmissionHistory)

Riwayat kiriman (mencakup riwayat 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 tertentu bergantung pada nilai course_work_type. content hanya dapat berupa salah satu dari berikut:
assignmentSubmission

object (AssignmentSubmission)

Kirimkan konten saat courseWorkType adalah TUGAS.

Siswa dapat mengubah konten ini menggunakan studentSubmissions.modifyAttachments.

shortAnswerSubmission

object (ShortAnswerSubmission)

Konten pengiriman jika courseWorkType berstatus SHORT_ANSWER_ANSWER.

multipleChoiceSubmission

object (MultipleChoiceSubmission)

Konten pengiriman jika courseWorkType adalah MULTIPLE_CHOICE_QUESTION.

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 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 tingkat. Level mungkin memiliki atau tidak memiliki poin. Jika tidak disetel, tidak ada titik 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 Identifier dan alternateLink selalu tersedia, tetapi kolom lainnya (misalnya, title) mungkin tidak tersedia.

Keterikatan

Lampiran ditambahkan ke tugas tugas siswa.

Saat membuat lampiran, menyetel 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 ada berupa salah satu diantara 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 dengan 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 pilihan siswa.

SubmissionHistory

Histori pengiriman. Histori ini saat ini mencakup histori status dan 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 ada berupa salah satu diantara berikut:
stateHistory

object (StateHistory)

Informasi histori status pengiriman, jika ada.

gradeHistory

object (GradeHistory)

Informasi histori nilai kiriman, jika ada.

StateHistory

Histori setiap negara bagian tempat pengiriman ini berada.

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 Tidak ada negara bagian yang ditetapkan. Ini tidak boleh ditampilkan.
CREATED Kiriman telah dibuat.
TURNED_IN Siswa telah menyerahkan dokumen yang ditugaskan, yang mungkin merupakan template atau tidak.
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 memegang kendali sebagai pemilik.
STUDENT_EDITED_AFTER_TURN_IN Siswa mengedit kirimannya setelah menyerahkannya. Saat ini, hanya digunakan oleh Pertanyaan, ketika siswa mengedit jawaban mereka.

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 saat ini dalam histori nilai kiriman.

maxPoints

number

Penyebut nilai saat ini dalam histori nilai kiriman.

gradeTimestamp

string (Timestamp format)

Saat nilai tugas 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 mengubah nilai.

gradeChangeType

enum (GradeChangeType)

Jenis perubahan nilai saat ini dalam histori nilai kiriman.

GradeChangeType

Kemungkinan jenis perubahan nilai.

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

Metode

get

Menampilkan kiriman siswa.

list

Menampilkan daftar kiriman siswa yang boleh dilihat pemohon, dengan memperhitungkan cakupan OAuth permintaan.

modifyAttachments

Memodifikasi lampiran kiriman siswa.

patch

Memperbarui satu atau beberapa kolom yang dikirimkan siswa.

reclaim

Mengklaim ulang kiriman siswa atas nama siswa yang memilikinya.

return

Menampilkan kiriman siswa.

turnIn

Menyerahkan kiriman siswa.