REST Resource: courses.courseWork

Kaynak: CourseWork

Öğretmen tarafından kurs öğ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

Kursun tanımlayıcısı.

Salt okunur.
id

string

Bu sınıf çalışmasının Classroom tarafından atanan tanımlayıcısı. Her ders için benzersizdir.

Salt okunur.
title

string

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

string

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

object (Material)

Ek materyaller.

CourseWork'te en fazla 20 materyal öğesi olabilir.
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ı gösteren zaman damgası.

Salt okunur.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da 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 ders çalışmasında yapılan en son değişikliğin zaman damgası.

Salt okunur.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da 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ı için gönderimlerin teslim edilmesi gereken isteğe bağlı tarih (UTC). dueTime belirtilmişse bu özellik de belirtilmelidir.
dueTime

object (TimeOfDay)

Bu kurs çalışması için gönderimlerin teslim edilmesi gereken isteğe bağlı günün saati (UTC). dueDate belirtilmişse bu özellik de belirtilmelidir.
scheduledTime

string (Timestamp format)

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

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da 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ırsa veya belirtilmemişse bu ödev 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 ayarlanır ve değiştirilemez.
associatedWithDeveloper

boolean

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

Daha fazla ayrıntı için courseWork.create sayfasına bakın.

Salt okunur.
assigneeMode

enum (AssigneeMode)

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

object (IndividualStudentsOptions)

Kurs içeriğine erişimi olan öğrencilerin tanımlayıcıları. Bu alan yalnızca assigneeMode INDIVIDUAL_STUDENTS ise ayarlanır. assigneeMode INDIVIDUAL_STUDENTS ise kurs çalışması yalnızca bu alanda belirtilen öğrencilere atanır.
submissionModificationMode

enum (SubmissionModificationMode)

Öğrencilerin gönderimleri ne zaman değiştirmesine izin verileceğini belirleyen ayar. Belirtilmediği takdirde varsayılan değer MODIFIABLE_UNTIL_TURNED_IN olur.
creatorUserId

string

Kurs materyalini oluşturan kullanıcının tanımlayıcısı.

Salt okunur.
topicId

string

Bu ödevin ilişkili olduğu konunun tanımlayıcısı. Kurstaki mevcut bir konuyla eşleşmelidir.
gradeCategory

object (GradeCategory)

Bu sınıf çalışmasının notunun katkıda bulunduğu kategori. Yalnızca ödev 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ü.
Birleştirme alanı details. Bir sınıf çalışması türüne özel ek ayrıntılar. details yalnızca aşağıdakilerden biri olabilir:
assignment

object (Assignment)

Ödev 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 değeri 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şturulurken belirtilmelidir. Aksi takdirde ayarlanmamalıdır.
gradingPeriodId

string

Ödevle ilişkili notlandırma döneminin tanımlayıcısı.

  • Oluşturma sırasında belirtilmemişse notlandırma dönemi kimliği dueDate'a (veya dueDate ayarlanmamışsa scheduledTime) göre ayarlanır.
  • Herhangi bir notlandırma dönemiyle ilişkilendirilmediğini belirtmek için bu alanı boş bir dize ("") olarak 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 değer hiçbir zaman döndürülmez.
PUBLISHED Yayınlanmış çalışmaları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 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önderimlerinde kullanılabilecek olası değişiklik modları.

Sıralamalar
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Değişiklik modu belirtilmedi. Bu değer hiçbir zaman döndürülmez.
MODIFIABLE_UNTIL_TURNED_IN Gönderimler, teslim edilmeden önce değiştirilebilir.
MODIFIABLE Gönderimler istediğiniz zaman değiştirilebilir.

Ödev

Ödevlerle ilgili ek ayrıntılar.

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

object (DriveFolder)

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

MultipleChoiceQuestion

Çoktan seçmeli sorularla ilgili 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ı geri verir.

getAddOnContext

 Belirli bir gönderi bağlamında Classroom eklentilerinin meta verilerini alır.

list

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

modifyAssignees

 Bir ödevin atananlar modunu ve seçeneklerini değiştirir.

patch

 Bir ödevin bir veya daha fazla alanını günceller.