REST Resource: courses.courseWork

Kaynak: CourseWork

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

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": string
}
Alanlar
courseId

string

Dersin tanımlayıcısı.

Salt okunur.
id

string

Bu sınıf çalışmasının Classroom tarafından atanan ve her ders için benzersiz olan tanımlayıcısı.

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 ödevin isteğe bağlı açıklaması. Açıklama ayarlanmışsa en fazla 30.000 karakter içeren geçerli bir UTF-8 dizesi olmalıdır.
materials[]

object (Material)

Ek materyaller.

Sınıf çalışmasında en fazla 20 materyal öğesi bulunabilir.
state

enum (CourseWorkState)

Bu ödevin durumu. Belirtilmezse varsayılan durum DRAFT olur.
creationTime

string (Timestamp format)

Bu ödevin oluşturulduğu 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 ödevde 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 ödev için gönderimlerin son tarihi (UTC olarak, isteğe bağlı). dueTime belirtilmişse bu değer de belirtilmelidir.
dueTime

object (TimeOfDay)

Bu ödev için gönderimlerin son teslim saati (UTC olarak, isteğe bağlı). dueDate belirtilmişse bu değer de belirtilmelidir.
scheduledTime

string (Timestamp format)

Bu ödevin 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 değer, negatif olmayan bir tam sayı 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 ödev öğ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)

Sınıf çalışmasının atanan modu. Belirtilmezse varsayılan değer ALL_STUDENTS olur.
individualStudentsOptions

object (IndividualStudentsOptions)

Sınıf çalışmasına 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 çalışma materyali atanır.
submissionModificationMode

enum (SubmissionModificationMode)

Öğrencilerin gönderimleri ne zaman değiştirmesine izin verileceğini belirleme ayarı. Belirtilmezse 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ı. Dersteki mevcut bir konuyla eşleşmelidir.
gradeCategory

object (GradeCategory)

Bu çalışma materyalinin notunun katkıda bulunduğu kategori. Yalnızca çalışma materyali için bir kategori seçildiğinde gösterilir. Genel not hesaplanırken 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ıdır.

Bu sınıf çalışmasına eklenen öğrenme hedeflerine yapılan referanslar. Sınıf çalışmasında en fazla 10 öğrenme hedefi olabilir. Bu alan yalnızca uygun previewVersion ayarlandığında doldurulur.
Bir sınıf çalışması türüne özgü ek ayrıntılar. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
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, MULTIPLE_CHOICE_QUESTION değerine sahip bir workType ile ödev oluşturulurken belirtilmeli ve aksi takdirde ayarlanmamalıdır.
Birbirini hariç tutan alanların sonu.
gradingPeriodId

string

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

  • Oluşturma sırasında belirtilmezse notlandırma dönemi kimliği, dueDate (veya dueDate ayarlanmamışsa scheduledTime) değerine göre ayarlanır.
  • Herhangi bir notlandırma dönemiyle ilişkilendirme olmadığını belirtmek için bu alanı boş bir dize ("") olarak ayarlayın.
  • Belirtilmesi durumunda, kurstaki mevcut bir notlandırma dönemi kimliğiyle eşleşmelidir.

CourseWorkState

Ödevlerin olası durumları.

Sıralamalar
COURSE_WORK_STATE_UNSPECIFIED Eyalet belirtilmedi. Bu değer hiçbir zaman döndürülmez.
PUBLISHED Yayınlanan çalışmaların durumu. Bu, varsayılan durumdur.
DRAFT Henüz yayınlanmamış çalışmaların durumu. Bu durumdaki çalışmalar yalnızca ders öğretmenleri ve alan yöneticileri tarafından görülebilir.
DELETED Yayınlanmış ancak şu anda silinmiş olan ç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 dilediğiniz zaman değiştirilebilir.

Ödev

Ödevlerle ilgili ek ayrıntılar.

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

object (DriveFolder)

Öğrenci gönderimlerindeki eklerin yerleştirildiği Drive klasörü. Bu alan yalnızca ders öğ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

 Sınıf çalışmasını siler.

get

 Sınıf çalışmasını döndürür.

getAddOnContext

 Belirli bir yayın bağlamında Classroom eklentileri için meta verileri alır.

list

 İstekte bulunan kullanıcının görüntülemesine izin verilen ödevlerin listesini döndürür.

modifyAssignees

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

patch

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