REST Resource: courses.courseWork.studentSubmissions

Referensi: Tugas Siswa

Kiriman siswa untuk tugas kursus.

StudentSubmission item dibuat saat item CourseWork dibuat.

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

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

Hanya baca.
id

string

ID yang ditetapkan Classroom untuk kiriman siswa. Hal ini adalah keunikan 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. Kebijakan ini dapat tidak ditetapkan jika siswa belum mengakses item ini.

Hanya baca.

Stempel waktu dalam 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. Kebijakan ini dapat tidak ditetapkan jika siswa belum mengakses item ini.

Hanya baca.

Stempel waktu dalam 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 kiriman 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 ke dua angka desimal.

Bagian ini hanya dapat dilihat dan diubah oleh pengajar mata pelajaran.
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 ke dua angka desimal.

Ini hanya dapat diubah oleh pengajar mata pelajaran.
rubricId

string

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

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

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 kursus ini atau jika rubrik dilampirkan, tetapi tidak ada nilai yang ditetapkan berdasarkan 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))

Pemberian nilai rubrik 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 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 akan menerima kiriman 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 kiriman (termasuk histori status dan nilai).

Hanya baca.
previewVersion

enum (PreviewVersion)

Hanya output. Versi pratinjau API. Ini harus disetel agar dapat 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 yang berikut:
assignmentSubmission

object (AssignmentSubmission)

Kirim konten saat courseWorkType sedang PENETAPAN.

Siswa dapat mengubah konten ini menggunakan studentSubmissions.modifyAttachments.
shortAnswerSubmission

object (ShortAnswerSubmission)

Kirim konten saat courseWorkType adalah SHORT_ANSWER_QUESTION.
multipleChoiceSubmission

object (MultipleChoiceSubmission)

Kirim konten 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 pada tingkat yang dipilih. Jika kosong, tidak ada level yang dipilih.
points

number

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

AssignmentSubmission

Siswa mengerjakan 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 replaceLink selalu tersedia, tetapi kolom lainnya (misalnya, judul) mungkin tidak tersedia.

Lampiran

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

Siswa mengerjakan 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. Histori 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 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 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 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 kiriman.

Enum
STATE_UNSPECIFIED Tidak ada negara bagian yang ditentukan. Nilai ini tidak boleh ditampilkan.
CREATED Pengiriman telah dibuat.
TURNED_IN Siswa telah menyerahkan dokumen yang ditugaskan, yang mungkin berupa template atau tidak.
RETURNED Pengajar telah mengembalikan dokumen yang ditugaskan kepada siswa.
RECLAIMED_BY_STUDENT Siswa menyerahkan dokumen yang diberikan, lalu memilih untuk "membatalkan pengiriman" tugas, sehingga memberi siswa kontrol kembali sebagai pemilik tugas.
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 yang dikirimkan ini.

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

number

Pembilang nilai saat ini dalam riwayat nilai penyerahan.
maxPoints

number

Penyebut nilai saat ini dalam histori nilai pengiriman.
gradeTimestamp

string (Timestamp format)

Kapan nilai kiriman diubah.

Stempel waktu dalam 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 membuat perubahan nilai.
gradeChangeType

enum (GradeChangeType)

Jenis perubahan nilai saat ini dalam 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 pembilang draf nilai.
ASSIGNED_GRADE_POINTS_EARNED_CHANGE Perubahan 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 pemohon, dengan mempertimbangkan cakupan OAuth permintaan.

modifyAttachments

 Memodifikasi lampiran kiriman siswa.

patch

 Memperbarui satu atau beberapa kolom kiriman siswa.

reclaim

 Mengklaim kembali kiriman siswa atas nama siswa yang memilikinya.

return

 Menampilkan kiriman siswa.

turnIn

 Menyerahkan tugas yang dikirimkan siswa.