REST Resource: courses.courseWork

Resource: CourseWork

Tugas yang dibuat oleh pengajar untuk siswa kursus.

Representasi JSON 
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },
  "previewVersion": enum (PreviewVersion),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": string
}
Kolom
courseId

string

ID kursus.

Hanya baca.
id

string

ID yang ditetapkan Classroom untuk tugas kursus ini, unik per kursus.

Hanya baca.
title

string

Judul tugas kursus ini. Judul harus berupa string UTF-8 yang valid dan berisi antara 1 hingga 3.000 karakter.
description

string

Deskripsi opsional untuk tugas kelas ini. Jika ditetapkan, deskripsi harus berupa string UTF-8 yang valid dan berisi maksimal 30.000 karakter.
materials[]

object (Material)

Materi tambahan.

CourseWork tidak boleh memiliki lebih dari 20 item materi.
state

enum (CourseWorkState)

Status tugas kelas ini. Jika tidak ditentukan, status default-nya adalah DRAFT.
creationTime

string (Timestamp format)

Stempel waktu saat tugas kelas ini dibuat.

Hanya baca.

Menggunakan RFC 3339 yang outputnya 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)

Stempel waktu perubahan terbaru pada tugas kelas ini.

Hanya baca.

Menggunakan RFC 3339 yang outputnya 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".
dueDate

object (Date)

Tanggal opsional, dalam UTC, yang merupakan batas waktu pengiriman untuk tugas kursus ini. Ini harus ditentukan jika dueTime ditentukan.
dueTime

object (TimeOfDay)

Waktu opsional, dalam UTC, yang merupakan batas waktu pengiriman tugas kelas ini. Ini harus ditentukan jika dueDate ditentukan.
scheduledTime

string (Timestamp format)

Stempel waktu opsional saat tugas ini dijadwalkan untuk dipublikasikan.

Menggunakan RFC 3339 yang outputnya 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".
maxPoints

number

Nilai maksimum untuk tugas kelas ini. Jika nol atau tidak ditentukan, tugas ini dianggap tidak dinilai. Nilai ini harus berupa bilangan bulat non-negatif.
workType

enum (CourseWorkType)

Jenis tugas kursus ini.

Jenis ditetapkan saat tugas dibuat dan tidak dapat diubah.
associatedWithDeveloper

boolean

Apakah item tugas kelas ini terkait dengan project Konsol Developer yang membuat permintaan.

Lihat courseWork.create untuk mengetahui detail selengkapnya.

Hanya baca.
assigneeMode

enum (AssigneeMode)

Mode penerima tugas mata pelajaran. Jika tidak ditentukan, nilai defaultnya adalah ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

ID siswa yang memiliki akses ke tugas mata pelajaran. Kolom ini hanya ditetapkan jika assigneeMode adalah INDIVIDUAL_STUDENTS. Jika assigneeMode adalah INDIVIDUAL_STUDENTS, hanya siswa yang ditentukan dalam kolom ini yang akan diberi tugas mata pelajaran.
submissionModificationMode

enum (SubmissionModificationMode)

Setelan untuk menentukan kapan siswa diizinkan mengubah tugas yang dikirim. Jika tidak ditentukan, nilai defaultnya adalah MODIFIABLE_UNTIL_TURNED_IN.
creatorUserId

string

ID untuk pengguna yang membuat tugas mata pelajaran.

Hanya baca.
topicId

string

ID untuk topik yang terkait dengan tugas mata pelajaran ini. Harus cocok dengan topik yang ada dalam kursus.
gradeCategory

object (GradeCategory)

Kategori yang dipengaruhi oleh nilai tugas mata pelajaran ini. Hanya ada jika kategori telah dipilih untuk tugas mata pelajaran. Dapat digunakan dalam menghitung nilai keseluruhan.

Hanya baca.
previewVersion

enum (PreviewVersion)

Hanya output. Versi pratinjau API yang digunakan untuk mengambil resource ini.
learningGoals[]

object (LearningGoal)

Opsional.

Referensi ke sasaran pembelajaran yang dilampirkan ke tugas kelas ini. Tugas Mata Pelajaran dapat memiliki maksimal 10 sasaran pembelajaran. Kolom ini hanya diisi jika previewVersion yang sesuai ditetapkan.
Detail tambahan yang spesifik untuk jenis tugas kursus. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
assignment

object (Assignment)

Detail penetapan. Kolom ini hanya diisi jika workType adalah ASSIGNMENT.

Hanya baca.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

Detail pertanyaan pilihan ganda. Untuk operasi baca, kolom ini hanya diisi jika workType adalah MULTIPLE_CHOICE_QUESTION. Untuk operasi tulis, kolom ini harus ditentukan saat membuat tugas kelas dengan workType dari MULTIPLE_CHOICE_QUESTION, dan tidak boleh ditetapkan sebaliknya.
Akhir kolom yang saling eksklusif.
gradingPeriodId

string

ID periode penilaian yang terkait dengan tugas mata pelajaran.

  • Saat pembuatan, jika tidak ditentukan, ID periode penilaian akan ditetapkan berdasarkan dueDate (atau scheduledTime jika tidak ada dueDate yang ditetapkan).
  • Untuk menunjukkan tidak ada pengaitan ke periode penilaian apa pun, tetapkan kolom ini ke string kosong ("").
  • Jika ditentukan, ID ini harus cocok dengan ID periode penilaian yang ada di kursus.

CourseWorkState

Kemungkinan status tugas kursus.

Enum
COURSE_WORK_STATE_UNSPECIFIED Status tidak ditentukan. Nilai ini tidak pernah ditampilkan.
PUBLISHED Status untuk karya yang telah dipublikasikan. Ini adalah status default.
DRAFT Status untuk karya yang belum dipublikasikan. Tugas dalam status ini hanya dapat dilihat oleh pengajar kursus dan administrator domain.
DELETED Status untuk karya yang telah dipublikasikan, tetapi kini dihapus. Tugas dalam status ini hanya dapat dilihat oleh pengajar kursus dan administrator domain. Pekerjaan dalam status ini akan dihapus setelah beberapa waktu.

SubmissionModificationMode

Kemungkinan mode modifikasi untuk tugas siswa.

Enum
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED No modification mode specified. Nilai ini tidak pernah ditampilkan.
MODIFIABLE_UNTIL_TURNED_IN Pengiriman dapat diubah sebelum diserahkan.
MODIFIABLE Pengiriman dapat diubah kapan saja.

Pemindahan Hak

Detail tambahan untuk tugas.

Representasi JSON 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
Kolom
studentWorkFolder

object (DriveFolder)

Folder Drive tempat lampiran dari kiriman siswa ditempatkan. Kolom ini hanya diisi untuk pengajar dan administrator kursus.

MultipleChoiceQuestion

Detail tambahan untuk pertanyaan pilihan ganda.

Representasi JSON 
{
  "choices": [
    string
  ]
}
Kolom
choices[]

string

Pilihan yang memungkinkan.

Metode

create

 Membuat tugas kelas.

delete

 Menghapus tugas kelas.

get

 Mengembalikan tugas mata pelajaran.

getAddOnContext

 Mendapatkan metadata untuk add-on Classroom dalam konteks postingan tertentu.

list

 Menampilkan daftar tugas yang diizinkan untuk dilihat oleh pemohon.

modifyAssignees

 Mengubah mode penerima tugas dan opsi tugas mata pelajaran.

patch

 Memperbarui satu atau beberapa kolom tugas kelas.