- Referensi: StudentSubmission
- RubricGrade
- AssignmentSubmission
- Lampiran
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory
- Status
- GradeHistory
- GradeChangeType
- Metode
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 ( |
Kolom | |
---|---|
courseId |
ID kursus. Hanya baca. |
courseWorkId |
ID untuk tugas kursus yang terkait dengan ini. Hanya baca. |
id |
ID yang diberikan Classroom untuk kiriman siswa. Hal ini unik di antara kiriman untuk tugas materi yang relevan. Hanya baca. |
userId |
ID untuk siswa yang memiliki kiriman ini. Hanya baca. |
creationTime |
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: |
updateTime |
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: |
state |
Status penyerahan tugas ini. Hanya baca. |
late |
Apakah pengiriman ini terlambat. Hanya baca. |
draftGrade |
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 |
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 |
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 |
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 |
assignedRubricGrades |
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 |
alternateLink |
Link absolut ke kiriman di UI web Classroom. Hanya baca. |
courseWorkType |
Jenis tugas kursus yang digunakan untuk kiriman ini. Hanya baca. |
associatedWithDeveloper |
Apakah kiriman siswa ini dikaitkan dengan project Konsol Developer yang membuat permintaan tersebut. Lihat Hanya baca. |
submissionHistory[] |
Riwayat kiriman (mencakup riwayat status dan nilai). Hanya baca. |
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 |
Kirimkan konten saat courseWorkType adalah TUGAS. Siswa dapat mengubah konten ini menggunakan |
shortAnswerSubmission |
Konten pengiriman jika courseWorkType berstatus SHORT_ANSWER_ANSWER. |
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 |
Opsional. ID kriteria. |
levelId |
Opsional. ID tingkat opsional dari tingkat yang dipilih. Jika kosong, tidak ada tingkat yang dipilih. |
points |
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 ( |
Kolom | |
---|---|
attachments[] |
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 |
Kolom | |
---|---|
Kolom union attachment . Data lampiran. attachment hanya ada berupa salah satu diantara berikut: |
|
driveFile |
Lampiran file Google Drive. |
youTubeVideo |
Lampiran video YouTube. |
link |
Lampiran link. |
form |
Lampiran Google Formulir. |
ShortAnswerSubmission
Tugas siswa untuk pertanyaan dengan jawaban singkat.
Representasi JSON |
---|
{ "answer": string } |
Kolom | |
---|---|
answer |
Respons siswa terhadap pertanyaan jawaban singkat. |
MultipleChoiceSubmission
Tugas siswa untuk pertanyaan pilihan ganda.
Representasi JSON |
---|
{ "answer": string } |
Kolom | |
---|---|
answer |
Pilihan pilihan siswa. |
SubmissionHistory
Histori pengiriman. Histori ini saat ini mencakup histori status dan nilai.
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom union type . Jenis SubmissionHistory, dapat berupa salah satu dari StateHistory, GradeHistory. type hanya ada berupa salah satu diantara berikut: |
|
stateHistory |
Informasi histori status pengiriman, jika ada. |
gradeHistory |
Informasi histori nilai kiriman, jika ada. |
StateHistory
Histori setiap negara bagian tempat pengiriman ini berada.
Representasi JSON |
---|
{
"state": enum ( |
Kolom | |
---|---|
state |
Tahap pipeline alur kerja. |
stateTimestamp |
Saat kiriman memasuki status ini. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
actorUserId |
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 ( |
Kolom | |
---|---|
pointsEarned |
Pembilang nilai saat ini dalam histori nilai kiriman. |
maxPoints |
Penyebut nilai saat ini dalam histori nilai kiriman. |
gradeTimestamp |
Saat nilai tugas diubah. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
actorUserId |
Pengajar yang mengubah nilai. |
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 |
|
---|---|
|
Menampilkan kiriman siswa. |
|
Menampilkan daftar kiriman siswa yang boleh dilihat pemohon, dengan memperhitungkan cakupan OAuth permintaan. |
|
Memodifikasi lampiran kiriman siswa. |
|
Memperbarui satu atau beberapa kolom yang dikirimkan siswa. |
|
Mengklaim ulang kiriman siswa atas nama siswa yang memilikinya. |
|
Menampilkan kiriman siswa. |
|
Menyerahkan kiriman siswa. |