REST Resource: courses.courseWork

Kaynak: CourseWork

Bir öğretmen tarafından dersin öğrencileri için oluşturulan sınıf çalışması.

JSON gösterimi 
{
  "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
}
Alanlar
courseId

string

Dersin tanımlayıcısıdır.

Salt okunur.
id

string

Bu sınıf çalışmasının Classroom tarafından atanan, kurs başına benzersiz bir tanımlayıcısıdır.

Salt okunur.
title

string

Bu sınıf çalışmasının başlığı. Başlık, 1 ila 3.000 karakter içeren geçerli bir UTF-8 dizesi olmalıdır.
description

string

Bu kurs çalışmasının isteğe bağlı açıklaması. Ayarlandıysa açıklama, en fazla 30.000 karakter içeren geçerli bir UTF-8 dizesi olmalıdır.
materials[]

object (Material)

Ek materyaller.

Öğrenim materyali en fazla 20 öğe içermelidir.
state

enum (CourseWorkState)

Bu kurs çalışmasının durumu. Belirtilmemişse varsayılan durum DRAFT olur.
creationTime

string (Timestamp format)

Bu sınıf çalışmasının oluşturulduğu zaman damgası.

Salt okunur.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Bu kurs çalışmasında yapılan en son değişikliğin zaman damgası.

Salt okunur.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
dueDate

object (Date)

Bu kurs çalışmasının teslim tarihinin UTC saat diliminde belirtildiği isteğe bağlı tarih. dueTime belirtilmişse bu özellik de belirtilmelidir.
dueTime

object (TimeOfDay)

Bu kurs çalışmasının teslim tarihinin UTC saat diliminde isteğe bağlı saati. dueDate belirtilmişse bu özellik de belirtilmelidir.
scheduledTime

string (Timestamp format)

Bu sınıf çalışmasının yayınlanması planlanan isteğe bağlı zaman damgası.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
maxPoints

number

Bu sınıf çalışması için maksimum not. Sıfır veya belirtilmemişse bu ödeve not verilmemiş olarak kabul edilir. Bu, negatif olmayan bir tam sayı değeri olmalıdır.
workType

enum (CourseWorkType)

Bu sınıf çalışmasının türü.

Tür, kurs çalışması oluşturulurken belirlenir ve değiştirilemez.
associatedWithDeveloper

boolean

Bu kurs çalışması öğesinin, isteği gönderen Developer Console projesiyle ilişkili olup olmadığı.

Ayrıntılı bilgi için courseWork.create sayfasına bakın.

Salt okunur.
assigneeMode

enum (AssigneeMode)

Ders çalışmasının atananı modu. Belirtilmediği takdirde varsayılan değer ALL_STUDENTS olur.
individualStudentsOptions

object (IndividualStudentsOptions)

Ders materyallerine erişimi olan öğrencilerin tanımlayıcıları. Bu alan yalnızca assigneeMode INDIVIDUAL_STUDENTS ise ayarlanır. assigneeMode INDIVIDUAL_STUDENTS ise yalnızca bu alanda belirtilen öğrencilere kurs verilir.
submissionModificationMode

enum (SubmissionModificationMode)

Öğrencilerin gönderimleri ne zaman değiştirebileceğini belirlemek için kullanılan ayar. Belirtilmediği takdirde varsayılan değer MODIFIABLE_UNTIL_TURNED_IN olur.
creatorUserId

string

Ödevi oluşturan kullanıcının tanımlayıcısıdır.

Salt okunur.
topicId

string

Bu ders çalışmasının ilişkili olduğu konunun tanımlayıcısıdır. Kurstaki mevcut bir konuyla eşleşmelidir.
gradeCategory

object (GradeCategory)

Bu ödevin notunun dahil edildiği kategori. Yalnızca sınıf çalışması için bir kategori seçildiğinde gösterilir. Genel notu hesaplamak için kullanılabilir.

Salt okunur.
previewVersion

enum (PreviewVersion)

Yalnızca çıkış. Bu kaynağı almak için kullanılan API'nin önizleme sürümü.
Birlik alanı details. Bir ders çalışması türüne özel ek ayrıntılar. details yalnızca aşağıdakilerden biri olabilir:
assignment

object (Assignment)

Atama ayrıntıları. Bu alan yalnızca workType ASSIGNMENT olduğunda doldurulur.

Salt okunur.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

Çoktan seçmeli soru ayrıntıları. Okuma işlemleri için bu alan yalnızca workType MULTIPLE_CHOICE_QUESTION olduğunda doldurulur. Yazma işlemleri için bu alan, workType değeri MULTIPLE_CHOICE_QUESTION olan bir kurs çalışması oluştururken belirtilmelidir ve başka şekilde ayarlanmamalıdır.
gradingPeriodId

string

Ders çalışmasıyla ilişkili notlandırma döneminin tanımlayıcısı.

  • Oluşturulma sırasında belirtilmezse notlandırma dönemi kimliği, dueDate'e (veya dueDate ayarlanmamışsa scheduledTime'e) göre ayarlanır.
  • Hiçbir notlandırma dönemiyle ilişki olmadığını belirtmek için bu alanı boş bir dizeye ("") ayarlayın.
  • Belirtilmişse kurstaki mevcut bir notlandırma dönemi kimliğiyle eşleşmelidir.

CourseWorkState

Sınıf çalışmasının olası durumları.

Sıralamalar
COURSE_WORK_STATE_UNSPECIFIED Eyalet belirtilmedi. Bu bilgiler hiçbir zaman geri gönderilmez.
PUBLISHED Yayınlanan çalışmanın durumu. Bu, varsayılan durumdur.
DRAFT Henüz yayınlanmamış çalışmaların durumu. Bu durumdaki çalışmalar yalnızca kurs öğretmenleri ve alan yöneticileri tarafından görülebilir.
DELETED Yayınlanmış ancak artık silinmiş çalışmaların durumu. Bu durumdaki çalışmalar yalnızca kurs öğretmenleri ve alan yöneticileri tarafından görülebilir. Bu durumdaki çalışmalar bir süre sonra silinir.

SubmissionModificationMode

Öğrenci gönderimleri için olası değişiklik modları.

Sıralamalar
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Değişiklik modu belirtilmedi. Bu bilgiler hiçbir zaman geri gönderilmez.
MODIFIABLE_UNTIL_TURNED_IN Gönderimler teslim edilmeden önce değiştirilebilir.
MODIFIABLE Gönderimler istediğiniz zaman değiştirilebilir.

Ödev

Ödevler için ek ayrıntılar.

JSON gösterimi 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
Alanlar
studentWorkFolder

object (DriveFolder)

Öğrencilerin gönderimlerindeki eklerin yerleştirildiği Drive klasörü. Bu alan yalnızca kurs öğretmenleri ve yöneticileri için doldurulur.

MultipleChoiceQuestion

Çoktan seçmeli sorular için ek ayrıntılar.

JSON gösterimi 
{
  "choices": [
    string
  ]
}
Alanlar
choices[]

string

Olası seçenekler.

Yöntemler

create

 Sınıf çalışması oluşturur.

delete

 Ders çalışmasını siler.

get

 Sınıf çalışmalarını döndürme

getAddOnContext

 Belirli bir yayın bağlamında Classroom eklentilerinin meta verilerini alır.

list

 İsteği gönderen kullanıcının görüntülemesine izin verilen kurs çalışmalarının listesini döndürür.

modifyAssignees

 Ödevin atananı modunu ve seçeneklerini değiştirir.

patch

 Bir ders çalışmasının bir veya daha fazla alanını günceller.