REST Resource: courses.courseWork

Resource: CourseWork

Tugas kursus 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),

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
  "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 yang berisi antara 1 dan 3.000 karakter.
description

string

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

object (Material)

Materi tambahan.

Materi Kursus tidak boleh memiliki lebih dari 20 item materi.
state

enum (CourseWorkState)

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

string (Timestamp format)

Stempel waktu saat tugas kursus ini dibuat.

Hanya baca.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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 kursus ini.

Hanya baca.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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, batas waktu pengiriman tugas kursus ini. Ini harus ditentukan jika dueTime ditentukan.
dueTime

object (TimeOfDay)

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

string (Timestamp format)

Stempel waktu opsional saat tugas kursus ini dijadwalkan untuk dipublikasikan.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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 kursus ini. Jika nol atau tidak ditentukan, tugas ini dianggap tidak dinilai. Nilai ini harus berupa nilai bilangan bulat positif.
workType

enum (CourseWorkType)

Jenis tugas kursus ini.

Jenis ditetapkan saat tugas kursus dibuat dan tidak dapat diubah.
associatedWithDeveloper

boolean

Apakah item tugas kursus ini dikaitkan dengan project Konsol Play yang membuat permintaan.

Lihat courseWork.create untuk mengetahui detail selengkapnya.

Hanya baca.
assigneeMode

enum (AssigneeMode)

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

object (IndividualStudentsOptions)

ID siswa yang memiliki akses ke materi kursus. Kolom ini hanya ditetapkan jika assigneeMode adalah INDIVIDUAL_STUDENTS. Jika assigneeMode adalah INDIVIDUAL_STUDENTS, hanya siswa yang ditentukan di kolom ini yang akan diberi tugas kursus.
submissionModificationMode

enum (SubmissionModificationMode)

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

string

ID untuk pengguna yang membuat materi kursus.

Hanya baca.
topicId

string

ID untuk topik yang terkait dengan materi kursus ini. Harus cocok dengan topik yang ada di kursus.
gradeCategory

object (GradeCategory)

Kategori yang menjadi kontribusi nilai tugas kursus ini. Hanya ditampilkan jika kategori telah dipilih untuk tugas kursus. Dapat digunakan dalam menghitung nilai keseluruhan.

Hanya baca.
previewVersion

enum (PreviewVersion)

Hanya output. Versi pratinjau API yang digunakan untuk mengambil resource ini.
Kolom union details. Detail tambahan yang khusus untuk jenis tugas kursus. details hanya dapat berupa salah satu dari berikut:
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 kursus dengan workType MULTIPLE_CHOICE_QUESTION, dan tidak boleh ditetapkan sebaliknya.
gradingPeriodId

string

ID periode penilaian yang terkait dengan 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 hubungan dengan 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 pekerjaan 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 dipublikasikan, tetapi sekarang 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 perubahan untuk kiriman siswa.

Enum
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Tidak ada mode modifikasi yang ditentukan. Nilai ini tidak pernah ditampilkan.
MODIFIABLE_UNTIL_TURNED_IN Pengiriman dapat diubah sebelum diserahkan.
MODIFIABLE Kiriman 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

Kemungkinan pilihan.

Metode

create

 Membuat tugas kursus.

delete

 Menghapus tugas kursus.

get

 Menampilkan tugas mata pelajaran.

getAddOnContext

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

list

 Menampilkan daftar tugas kursus yang diizinkan untuk dilihat oleh pemohon.

modifyAssignees

 Mengubah mode penerima tugas dan opsi materi.

patch

 Memperbarui satu atau beberapa kolom tugas kursus.