REST Resource: courses.courseWork

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

Hanya baca.

title

string

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

description

string

Deskripsi opsional tugas kursus ini. Jika ditetapkan, deskripsi harus berupa string UTF-8 valid yang berisi tidak 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.

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)

Stempel waktu perubahan terbaru untuk tugas kursus 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".

dueDate

object (Date)

Tanggal opsional, dalam UTC, batas waktu pengiriman tugas kursus ini. Kolom ini harus ditentukan jika dueTime ditentukan.

dueTime

object (TimeOfDay)

Waktu opsional dalam sehari, dalam UTC, batas waktu pengiriman tugas materi ini. Kolom ini harus ditentukan jika dueDate ditentukan.

scheduledTime

string (Timestamp format)

Stempel waktu opsional saat tugas kursus ini dijadwalkan untuk dipublikasikan.

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

maxPoints

number

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

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 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 dengan akses ke tugas mata pelajaran. Kolom ini ditetapkan hanya jika assigneeMode adalah INDIVIDUAL_STUDENTS. Jika assigneeMode adalah INDIVIDUAL_STUDENTS, berarti hanya siswa yang ditentukan di kolom ini yang diberi tugas.

submissionModificationMode

enum (SubmissionModificationMode)

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

creatorUserId

string

ID untuk pengguna yang membuat tugas kursus.

Hanya baca.

topicId

string

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

gradeCategory

object (GradeCategory)

Kategori yang berkontribusi pada nilai tugas kursus ini. Hanya presentasikan ketika kategori telah dipilih untuk tugas kursus. Dapat digunakan untuk 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 spesifik untuk jenis tugas pelatihan tertentu. 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 dari MULTIPLE_CHOICE_QUESTION, dan tidak boleh ditetapkan sebaliknya.

gradingPeriodId

string

ID periode penilaian yang terkait dengan tugas.

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

CourseWorkState

Status tugas kursus yang mungkin.

Enum
COURSE_WORK_STATE_UNSPECIFIED Tidak ada negara bagian yang ditentukan. Data ini tidak pernah ditampilkan.
PUBLISHED Status untuk tugas yang telah dipublikasikan. Ini adalah status default.
DRAFT Status untuk tugas yang belum dipublikasikan. Pekerjaan dalam status ini hanya dapat dilihat oleh pengajar mata pelajaran dan administrator domain.
DELETED Status untuk tugas yang telah dipublikasikan, tetapi sekarang dihapus. Pekerjaan dalam status ini hanya dapat dilihat oleh pengajar mata pelajaran dan administrator domain. Pekerjaan dalam status ini akan dihapus setelah beberapa waktu.

SubmissionModificationMode

Mode modifikasi yang mungkin untuk tugas yang dikirimkan siswa.

Enum
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Tidak ada mode modifikasi yang ditentukan. Data 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

Pilihan yang memungkinkan.

Metode

create

Membuat tugas kursus.

delete

Menghapus tugas kursus.

get

Menampilkan tugas kursus.

getAddOnContext

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

list

Menampilkan daftar tugas mata pelajaran yang diizinkan untuk dilihat pemohon.

modifyAssignees

Memodifikasi mode penerima tugas dan opsi tugas.

patch

Memperbarui satu atau beberapa kolom tugas kursus.