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 tugas kursus yang ditetapkan Classroom, unik per kursus.

Hanya baca.
title

string

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

string

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

object (Material)

Materi tambahan.

CourseWork tidak boleh memiliki lebih dari 20 item materi.
state

enum (CourseWorkState)

Status tugas kursus ini. Jika tidak ditentukan, status defaultnya 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 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 kursus ini.

Hanya baca.

Menggunakan RFC 3339, dengan output yang dihasilkan 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, saat batas waktu pengiriman tugas kursus ini. Ini harus ditentukan jika dueTime ditentukan.
dueTime

object (TimeOfDay)

Waktu opsional dalam sehari, dalam UTC, saat tugas kursus ini harus diserahkan. 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 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 mata kuliah ini. Jika nol atau tidak ditentukan, tugas ini dianggap tidak dinilai. Nilai ini harus berupa 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 terkait dengan project Konsol Developer yang membuat permintaan.

Lihat courseWork.create untuk mengetahui detail selengkapnya.

Hanya baca.
assigneeMode

enum (AssigneeMode)

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

object (IndividualStudentsOptions)

ID siswa yang memiliki akses ke tugas mata pelajaran. Kolom ini hanya disetel jika assigneeMode adalah INDIVIDUAL_STUDENTS. Jika assigneeMode adalah INDIVIDUAL_STUDENTS, hanya siswa yang ditentukan dalam 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 pengguna yang membuat tugas kelas.

Hanya baca.
topicId

string

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

object (GradeCategory)

Kategori yang berkontribusi pada nilai tugas ini. Hanya ditampilkan jika kategori telah dipilih untuk tugas kelas. 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 mata kuliah. details hanya dapat berupa salah satu dari berikut:
assignment

object (Assignment)

Detail tugas. Ini hanya diisi jika workType adalah ASSIGNMENT.

Hanya baca.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

Detail pertanyaan pilihan ganda. Untuk operasi baca, kolom ini diisi hanya 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 jika tidak.
gradingPeriodId

string

ID periode penilaian yang terkait dengan tugas kelas.

  • Saat pembuatan, jika tidak ditentukan, ID periode penilaian akan ditetapkan berdasarkan dueDate (atau scheduledTime jika tidak ada dueDate yang ditetapkan).
  • Untuk menunjukkan tidak ada kaitan dengan periode penilaian, 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 Negara bagian tidak ditentukan. Ini tidak pernah ditampilkan.
PUBLISHED Status untuk tugas yang telah dipublikasikan. Ini adalah status default.
DRAFT Status untuk pekerjaan yang belum dipublikasikan. Tugas dalam status ini hanya dapat dilihat oleh pengajar kursus dan administrator domain.
DELETED Status untuk karya yang 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 kiriman siswa.

Enum
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Tidak ada mode modifikasi yang ditentukan. Ini tidak pernah ditampilkan.
MODIFIABLE_UNTIL_TURNED_IN Kiriman 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 kelas.

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 dan opsi penerima tugas dari tugas kelas.

patch

 Memperbarui satu atau beberapa kolom tugas kelas.