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),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "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 ile 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.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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 kurs çalışmasında yapılan en son değişikliğin zaman damgası.

Salt okunur.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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ı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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ır 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, ödev 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 bilgi için courseWork.create sayfasına bakın.

Salt okunur.
assigneeMode

enum (AssigneeMode)

Çalışma materyalinin 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 çalışma materyali 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

Çalışma materyalini oluşturan kullanıcının tanımlayıcısı.

Salt okunur.
topicId

string

Bu çalışma materyalinin ilişkili olduğu konunun tanımlayıcısı. Kurstaki mevcut bir konuyla eşleşmelidir.
gradeCategory

object (GradeCategory)

Bu ödevin notunun katkıda bulunduğu kategori. Yalnızca sınıf çalışması için bir kategori seçildiğinde gösterilir. Genel notu hesaplarken kullanılabilir.

Salt okunur.
previewVersion

enum (PreviewVersion)

Yalnızca çıkış. Bu kaynağı almak için kullanılan API'nin önizleme sürümü.
learningGoals[]

object (LearningGoal)

İsteğe bağlı.

Bu ders çalışmasına eklenen öğrenme hedeflerine yapılan referanslar Bu alan yalnızca uygun PreviewVersion ayarlandığında doldurulur. CourseWork'te en fazla 10 öğrenme hedefi olabilir.
details birleşik alanı. Bir sınıf çalışması türüne özel ek ayrıntılar. details aşağıdakilerden yalnızca 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 ve 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'ya (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

Kurs çalışmaları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önderimleri için 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öneticiler 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

 Ödevleri siler.

get

 Sınıf çalışmalarını geri verir.

getAddOnContext

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

list

 İstekte bulunan kullanıcının görüntülemesine izin verilen kurs çalışmalarının listesini döndürür.

modifyAssignees

 Bir çalışma materyalinin atanan modu ve seçeneklerini değiştirir.

patch

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