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)
  },

  // 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.
}
Kolom
courseId

string

ID kursus.

Hanya baca.
id

string

ID tugas kursus ini yang diberikan Classroom, unik per kursus.

Hanya baca.
title

string

Judul tugas kursus ini. Judul harus berupa string UTF-8 yang valid dan berisi antara 1 hingga 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 default-nya adalah DRAFT.
creationTime

string (Timestamp format)

Stempel waktu saat tugas kursus ini dibuat.

Hanya baca.

Stempel waktu dalam format 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 pada tugas kursus ini.

Hanya baca.

Stempel waktu dalam format 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 pengumpulan tugas kursus ini. Kolom ini harus ditentukan jika dueTime ditentukan.
dueTime

object (TimeOfDay)

Waktu opsional, dalam UTC, batas waktu pengumpulan tugas kursus 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 format 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 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 dikaitkan dengan proyek Konsol Pengembang yang membuat permintaan.

Lihat courseWork.create untuk mengetahui detail selengkapnya.

Hanya baca.
assigneeMode

enum (AssigneeMode)

Mode penerima tugas untuk 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 disetel jika assigneeMode adalah INDIVIDUAL_STUDENTS. Jika assigneeMode adalah INDIVIDUAL_STUDENTS, hanya siswa yang ditentukan di kolom ini yang diberi tugas mata pelajaran.
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 mata pelajaran.

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 akan diberikan oleh nilai tugas mata pelajaran ini. Presentasikan hanya jika kategori telah dipilih untuk tugas mata pelajaran. Dapat digunakan untuk menghitung nilai keseluruhan.

Hanya baca.
Kolom union details. Rincian tambahan yang khusus untuk jenis tugas kursus. details hanya ada berupa salah satu diantara berikut:
assignment

object (Assignment)

Detail tugas. 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.

CourseWorkState

Kemungkinan status tentu saja berfungsi.

Enum
COURSE_WORK_STATE_UNSPECIFIED Tidak ada negara bagian yang ditetapkan. 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 kursus dan administrator domain.
DELETED Status untuk tugas yang telah dipublikasikan, tetapi sekarang dihapus. Pekerjaan dalam status ini hanya dapat dilihat oleh pengajar kursus dan administrator domain. Pekerjaan dengan status ini akan dihapus setelah beberapa saat.

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 Pengiriman dapat diubah kapan saja.

Assignment

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 kursus yang diizinkan untuk dilihat pemohon.

modifyAssignees

 Memodifikasi mode penerima tugas dan opsi tugas mata pelajaran.

patch

 Memperbarui satu atau beberapa kolom tugas kursus.